Skip to navigation

Create Note

Creates a note about one contact. The authenticated user owns the note. Send a title, a body, or both. First, leading and trailing whitespace is removed from title and body. After that, at least one of them must contain a character, and the length limits apply. The maximum length of title is 255 characters. Some emoji and other symbols count as 2. The maximum length of body is 10,000 characters.

To add a reminder, send remind_at as an RFC 3339 date-time with seconds, an uppercase T, and Z or a ±hh:mm offset, such as 2026-11-01T13:00:00Z. The year must be from 1970 to 9999. The reminder is saved at that exact time. If reminders are not available on the account, the request returns 403 and no note is created.

Creating a note is not idempotent: each call creates a new note. A request that fails or times out can still create the note. Before you retry, use List Notes with the contact to check.

Note: Requires the Contacts API on your plan.

Required scopes

contacts:write

Authentication

AuthorizationBearer
OAuth 2.0
OR
AuthorizationBearer
Personal Access Token

Request

This endpoint expects an object.
contactstringRequiredformat: "uri"
The URI of the contact that the note is about.
titlestring or nullOptional

The title of the note. Leading and trailing whitespace is removed. After that, the maximum length is 255 characters. Some emoji and other symbols count as 2. Omit it, send null, or send an empty string for no title.

bodystring or nullOptional

The plain-text content of the note. Leading and trailing whitespace is removed. After that, the maximum length is 10,000 characters. Omit it, send null, or send an empty string for no body.

remind_atstring or nullOptionalformat: "date-time"

When the reminder is due, as an RFC 3339 date-time with seconds, an uppercase T, and Z or a ±hh:mm offset, in the years 1970 to 9999. Omit it or send null for no reminder.

Response

Created
resourceobject
A note that a user wrote about a contact. Only the user who owns a note can see it.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error