# Créer une note de personne

> Ajoute une note au profil CRM de la personne identifiée par person id — l' id per- issu de l'API Personnes.

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

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

## Comportement

Ajoute une note au profil CRM de la personne identifiée par `person_id` — l'`id` `per-*` issu de l'[API Personnes](/fr/docs/crm/people-overview).

## 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` | `CONTACT_NOTES_UNAVAILABLE` | Le workspace n'est pas encore sur le modèle de contacts v2 |
| `404` | `PERSON_NOT_FOUND` | Aucune personne avec cet ID (également retourné pour les IDs sans le préfixe `per-`) |
