Champs du body
| Champ | Type | Requis | Description |
|---|---|---|---|
label | string | oui | Nom affiché, de 1 à 255 caractères, avec au moins une lettre ou un chiffre |
type | string | oui | TEXT, NUMBER, DATE, BOOLEAN ou DROPDOWN |
options | array | DROPDOWN uniquement | Au moins un objet { label, key? }. Refusé pour les autres types |
prompt | string | non | Consigne que l'AI CRM Manager suit pour remplir cet attribut à partir des appels |
should_prompt_override | boolean | non | Indique si l'IA peut écraser une valeur déjà renseignée |
Dérivation de la clé
La key est dérivée du label : minuscules, accents supprimés, séquences de caractères non alphanumériques remplacées par _, tronquée à 64 caractères. Industry segment devient industry_segment. Les clés d'options sont dérivées de la même façon.
Un label qui correspond à une clé réservée est refusé avec ATTRIBUTE_KEY_RESERVED. Les clés réservées sont : id, name, phone_numbers, website, industry, logo_url, last_activity, activity_history, sms_content, created_at et updated_at.
Réponse
Renvoie 201 avec l'attribut créé. source vaut allo et already_existed vaut false.
{
"data": {
"key": "industry_segment",
"label": "Industry segment",
"type": "DROPDOWN",
"options": [
{ "key": "smb", "label": "SMB" },
{ "key": "enterprise", "label": "Enterprise" }
],
"is_visible": true,
"prompt": "Choisis le segment correspondant à la taille de l'entreprise mentionnée pendant l'appel.",
"should_prompt_override": false,
"source": "allo",
"created_at": "2026-10-07T14:21:08",
"updated_at": "2026-10-07T14:21:08",
"already_existed": false
}
}
Créer deux fois le même attribut
L'appel peut être répété sans risque. Si un attribut avec la même clé et le même type existe déjà, l'endpoint renvoie 201 avec cet attribut et already_existed à true. Rien n'est créé et la définition existante reste inchangée. Si la clé existe avec un autre type, la requête renvoie 409 ATTRIBUTE_KEY_CONFLICT.
Limites
Chaque type dispose d'un nombre fixe d'emplacements par équipe. Lorsqu'un type est plein, créer un autre attribut de ce type renvoie 409 ATTRIBUTE_SLOTS_EXHAUSTED. Supprimez un attribut inutilisé ou choisissez un autre type.
Les attributs personnalisés ne sont disponibles que pour les équipes qui utilisent le nouveau modèle de contacts. Les autres équipes reçoivent 404 TEAM_NOT_FOUND.
Erreurs
| Statut | Code | Quand |
|---|---|---|
400 | ATTRIBUTE_LABEL_INVALID | label est vide, dépasse 255 caractères ou ne contient ni lettre ni chiffre |
400 | ATTRIBUTE_KEY_RESERVED | Le label correspond à une clé réservée |
400 | ATTRIBUTE_OPTION_INVALID | Un attribut DROPDOWN n'a aucune option, ou un label d'option est vide, dépasse 255 caractères ou est en doublon |
400 | ATTRIBUTE_OPTIONS_NOT_SUPPORTED | options envoyé pour un type autre que DROPDOWN |
400 | INVALID_REQUEST_BODY | type est absent ou inconnu |
403 | API_KEY_INSUFFICIENT_SCOPE | La clé n'a pas le scope CRM_WRITE |
404 | TEAM_NOT_FOUND | Le workspace n'utilise pas le nouveau modèle de contacts |
409 | ATTRIBUTE_KEY_CONFLICT | Un attribut avec cette clé existe déjà avec un autre type |
409 | ATTRIBUTE_SLOTS_EXHAUSTED | Aucun emplacement libre pour ce type |
409 | ATTRIBUTE_CONCURRENT_MODIFICATION | Les attributs ont été modifiés en même temps. Relancez la requête |