# Créer une boîte de réception

> Crée une boîte de réception appartenant à l'appelant et la retourne avec un 201 . Envoyez user id dans le corps JSON pour la créer pour un coéquipier : la…

`POST /v2/api/inboxes`

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

## Comportement

Crée une boîte de réception appartenant à l'appelant et la retourne avec un `201`. Envoyez `user_id` dans le corps JSON pour la créer pour un coéquipier : la boîte appartient alors au coéquipier et apparaît dans son sélecteur de boîtes. Seuls les admins et managers de l'espace de travail du coéquipier peuvent le faire.

Chaque ligne source doit être accessible au propriétaire de la boîte, avec les mêmes règles d'accès aux lignes que dans l'app. Une source avec une liste `conditions` vide couvre toute la ligne. Construisez les sources à partir de la `source` des [suggestions de boîtes](/fr/docs/inboxes/get-inbox-suggestions), ou de la `condition` des [options de menu](/fr/docs/inboxes/list-menu-options).

Les conditions de menu ne sont acceptées que sur une ligne dont la liste d'options de menu n'est pas vide. Sur toute autre ligne, utilisez une source sur toute la ligne.

Chaque ligne apparaît une seule fois dans `sources`. Pour couvrir plusieurs options de menu d'une ligne, mettez tous leurs chemins dans les `branches` d'une seule condition `MENU_BRANCH`.

## Erreurs

| Statut | Code | Quand |
|--------|------|-------|
| `400` | `INBOX_NAME_REQUIRED` | `name` est manquant ou vide |
| `400` | `INVALID_INBOX_SOURCE` | Une source, une condition ou une touche est nulle ou invalide, un chemin de menu n'est pas dans les [options de menu](/fr/docs/inboxes/list-menu-options) de cette ligne, deux sources ont le même `allo_number`, ou une boîte de coéquipier n'aurait plus aucune ligne dans l'espace de travail de l'appelant |
| `400` | `INVALID_REQUEST_BODY` | `name` dépasse 80 caractères, `emoji` dépasse 16, plus de 100 sources, ou plus de 10 conditions dans une source. `field_errors` nomme chaque champ |
| `400` | `INVALID_INBOX_FILTERS` | `filters` contient une clé inconnue ou une valeur invalide |
| `400` | `INBOX_LIMIT_REACHED` | Le propriétaire de la boîte a déjà 50 boîtes |
| `403` | `FORBIDDEN` | `user_id` est renseigné et l'appelant n'est ni admin ni manager de l'espace de travail de ce coéquipier |
| `403` | `ALLO_NUMBER_FORBIDDEN` | Une ligne source n'est pas accessible au propriétaire de la boîte, ou, avec `user_id`, n'est pas dans un espace de travail que l'appelant gère |
