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 viaGET /v2/api/users.email— utilise uniquement quanduser_idest 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. Les valeurs sont écrites sur le contact du numéro, et le contact est créé si le numéro n'en a pas.
{
"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.
{
"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.
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.
{
"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 |