# Create conversation note

> Adds an internal team note to a conversation. Notes are never visible to the contact.

`POST /v2/api/conversations/{contact_number}/notes`

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

## Behavior

Adds an internal team note to the conversation with `contact_number`. Notes are never visible to the contact.

Identify the line the conversation belongs to with either `allo_number` (E.164, list your lines with `GET /v2/api/numbers`) or `sender_id` (for sender-ID inbox conversations). Omitting both returns `400` with code `MISSING_ALLO_NUMBER_OR_SENDER_ID`.

## 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` | `MISSING_ALLO_NUMBER_OR_SENDER_ID` | Neither `allo_number` nor `sender_id` was provided |
| `403` | `ALLO_NUMBER_FORBIDDEN` | You do not have access to this Allo line |
| `404` | `SENDER_ID_NOT_FOUND` | No sender ID with this identifier on your account |
