# Créer un attribut d'entreprise

> Champ Type Requis Description ------- ------ -------- ------------- label string oui Nom affiché, de 1 à 255 caractères, avec au moins une lettre ou un…

`POST /v2/api/crm/companies/attributes`

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

## 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`.

```json
{
  "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 |
