Skip to main content
POST
Create person note
Required scope: NOTES_WRITE

Behavior

Adds a note to the CRM profile of the person identified by person_id — the per-* id from the People API.

Mentions

Mention teammates inline in content with @[Display Name](usr-xxxx) — they receive the same push, email, and in-app notifications as mentions made from the Allo apps. See the mentions guide.

Errors

Authorizations

Authorization
string
header
required

Path Parameters

person_id
string
required

Person ID (per-*) — the id field from the People API.

Example:

"per-abc123"

Body

application/json
content
string
required

Note text (max 4000 characters). Mention teammates inline with @[Name](usr-...), or @[all](all) to notify the whole team.

Example:

"Escalate to @[Jane Doe](usr-abc123) tomorrow"

Response

Note created

data
object