# Create person note

> Adds a note to a person's CRM profile.

`POST /v2/api/crm/people/{person_id}/notes`

<Note>
**Required scope:** `NOTES_WRITE`
</Note>

## Behavior

Adds a note to the CRM profile of the person identified by `person_id` — the `per-*` `id` from the [People API](/docs/crm/people-overview).

## 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](/docs/notes/overview#mentions).

## Errors

| Status | Code | When |
|--------|------|------|
| `400` | `EMPTY_NOTE_CONTENT` | `content` is missing or blank |
| `400` | `NOTE_CONTENT_TOO_LONG` | `content` exceeds 4,000 characters |
| `400` | `CONTACT_NOTES_UNAVAILABLE` | The workspace is not on the v2 contact model yet |
| `404` | `PERSON_NOT_FOUND` | No person with this ID (also returned for IDs without the `per-` prefix) |
