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.
contacts:write
Authentication
Request
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.
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.
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.