Skip to main content
POST
Creates a note authored by the token owner. The level decides who reads it: ALL shows it to everyone who may read all its records, SHARED to the people and groups named in grants, PRIVATE only to the author. Change it afterwards with Update CRM note.
Scope crm:write. The token owner needs the right to create notes and to read every record the note is on.

Request body

string
An id of 8 to 64 characters you choose. A repeated call with the same id returns the note it made instead of a second one.
string
required
Up to 200 characters.
array
required
The text as editor blocks, up to 1 MB.
string
default:"ALL"
ALL, SHARED or PRIVATE.
array
required
The records the note is on, 1 to 20.
array
default:"[]"
{ "userId": "..." } or { "groupId": "..." }, at most 200. Required for SHARED, not allowed otherwise.

Response

The created note, with status 201.
Last modified on November 13, 2026