# Créer une note de conversation

> Ajoute une note interne d'équipe à la conversation avec contact number . Les notes ne sont jamais visibles par le contact.

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

<Note>
**Scope requis :** `NOTES_WRITE`
</Note>

## Comportement

Ajoute une note interne d'équipe à la conversation avec `contact_number`. Les notes ne sont jamais visibles par le contact.

Identifiez la ligne à laquelle la conversation est rattachée avec `allo_number` (E.164, listez vos lignes avec `GET /v2/api/numbers`) ou `sender_id` (pour les conversations d'une boîte sender ID). Omettre les deux retourne une erreur `400` avec le code `MISSING_ALLO_NUMBER_OR_SENDER_ID`.

## Mentions

Mentionnez des coéquipiers inline dans `content` avec `@[Display Name](usr-xxxx)` — ils reçoivent les mêmes notifications push, email et in-app que les mentions faites depuis les applications Allo. Voir le [guide des mentions](/fr/docs/notes/overview#mentions).

## Erreurs

| Statut | Code | Quand |
|--------|------|-------|
| `400` | `EMPTY_NOTE_CONTENT` | `content` est manquant ou vide |
| `400` | `NOTE_CONTENT_TOO_LONG` | `content` dépasse 4 000 caractères |
| `400` | `MISSING_ALLO_NUMBER_OR_SENDER_ID` | Ni `allo_number` ni `sender_id` n'a été fourni |
| `403` | `ALLO_NUMBER_FORBIDDEN` | Vous n'avez pas accès à cette ligne Allo |
| `404` | `SENDER_ID_NOT_FOUND` | Aucun sender ID avec cet identifiant sur votre compte |
