# Ajouter des numeros

> Par defaut, les numeros sont ajoutes a la file assignee au proprietaire de la cle API. Pour ajouter a la file d'un coequipier, envoyez user id ou email dans…

`POST /v2/api/dialing-queues/current/numbers`

## Cibler la file d'un coequipier

Par defaut, les numeros sont ajoutes a la file assignee au proprietaire de la cle API. Pour ajouter a la file d'un coequipier, envoyez `user_id` ou `email` dans le **corps JSON**. Le coequipier doit appartenir a la meme equipe que le proprietaire de la cle API.

- `user_id` — l'emporte quand les deux sont fournis. Resolvez les ids des coequipiers via [`GET /v2/api/users`](/fr/docs/users/list-users).
- `email` — utilise uniquement quand `user_id` est absent.

Si le coequipier n'a pas de file en cours, une nouvelle file est creee avec le proprietaire de la cle API comme `creator_id` et le coequipier comme `assignee_id`. Si l'utilisateur resolu n'est pas dans votre equipe, la reponse est `404 ASSIGNEE_NOT_FOUND`.

## Champs personnalisés

Chaque numéro peut porter `custom_attributes` : des valeurs pour les champs personnalisés des personnes de votre équipe, indexées par la `key` du champ. Listez les clés avec [`GET /v2/api/crm/attributes`](/fr/docs/crm/list-attributes). Les valeurs sont écrites sur le contact du numéro, et le contact est créé si le numéro n'en a pas.

```json
{
  "numbers": [
    {
      "number": "+12125550010",
      "name": "John",
      "custom_attributes": {
        "lead_source": "Webinar",
        "deal_size": "1200",
        "next_meeting": "2026-11-03"
      }
    }
  ]
}
```

Les valeurs sont des chaînes, au format du champ :

| Type de champ | Valeur |
|---------------|--------|
| `TEXT` | N'importe quel texte |
| `NUMBER` | Un nombre, comme `1200` ou `12.5` |
| `DATE` | `YYYY-MM-DD` ou une date-heure ISO, ou un jour, un mois et une année à 4 chiffres séparés par `/`, `-` ou `.`, comme `03/04/2026` |
| `BOOLEAN` | `true`/`false`, `1`/`0`, `yes`/`no`, `y`/`n` ou `oui`/`non`, majuscules ou minuscules |
| `DROPDOWN` | Le label ou la clé d'une des options du champ |

### Ordre des dates

`03/04/2026` est le 3 avril en Europe et le 4 mars aux États-Unis. Envoyez `date_order` à côté de `numbers` pour préciser lequel : `DAY_FIRST` ou `MONTH_FIRST`. Il s'applique à tous les champs date de la requête.

```json
{
  "date_order": "MONTH_FIRST",
  "numbers": [
    { "number": "+12125550010", "custom_attributes": { "next_meeting": "11/03/2026" } }
  ]
}
```

Sans `date_order`, chaque champ date est lu dans l'ordre que ses propres valeurs imposent : `13/04/2026` ne peut être que jour en premier, `04/13/2026` que mois en premier. Quand les valeurs ne tranchent pas, le pays de votre numéro décide : mois en premier pour les États-Unis, jour en premier partout ailleurs.

Les valeurs vides sont ignorées. Quand le contact existe déjà, seuls ses champs vides sont remplis : une valeur déjà renseignée est conservée.

Cet endpoint ne crée jamais de champ personnalisé. Créez-les d'abord avec [`POST /v2/api/crm/attributes`](/fr/docs/crm/create-attribute).

Une clé qui ne correspond à aucun champ personnalisé de votre équipe, ou qui désigne un champ supprimé, est ignorée. Le numéro est tout de même ajouté avec ses attributs connus, et les clés inconnues sont listées dans `ignored_custom_attributes` : un tableau toujours présent d'entrées `{ "number", "keys" }`, avec `number` au format E.164. Le tableau est vide quand aucune clé n'a été ignorée.

```json
{
  "added": [{ "number_to": "+12125550010", "position": 0 }],
  "skipped": [],
  "ignored_custom_attributes": [
    { "number": "+12125550010", "keys": ["unknown_field"] }
  ]
}
```

Une clé connue avec une valeur inutilisable, c'est autre chose : le numéro n'est pas ajouté et revient dans `skipped` :

| `reason` | Signification |
|----------|---------------|
| `INVALID_CUSTOM_ATTRIBUTE_VALUE` | Une valeur ne correspond pas au type de son champ : `bientôt` ou `31/02/2026` pour un champ `DATE`, une année à 2 chiffres comme `03/04/26`, `peut-être` pour un champ `BOOLEAN` |
