# Creer une entreprise

> Champ Type Requis Description ------- ------ -------- ------------- name string oui Nom de l'entreprise website string non URL du site web industry string…

`POST /v2/api/crm/companies`

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

## Champs du body

| Champ | Type | Requis | Description |
|-------|------|--------|-------------|
| `name` | string | **oui** | Nom de l'entreprise |
| `website` | string | non | URL du site web |
| `industry` | string | non | Secteur d'activite |
| `custom_attributes` | object | non | Valeurs de vos attributs d'entreprise, indexées par clé d'attribut |

## Attributs personnalisés

`custom_attributes` définit les valeurs de vos [attributs d'entreprise](/fr/docs/crm/create-company-attribute). Créez d'abord l'attribut, puis utilisez sa `key` ici.

| Type d'attribut | Valeur acceptée |
|-----------------|-----------------|
| `TEXT` | Une chaîne |
| `NUMBER` | Un nombre JSON fini. Les chaînes sont rejetées. Relu comme un décimal : `180` est renvoyé sous la forme `180.0` |
| `BOOLEAN` | Un booléen JSON |
| `DATE` | `YYYY-MM-DD` ou une date-heure ISO. Stockée comme date et renvoyée au format `YYYY-MM-DD` |
| `DROPDOWN` | Une clé ou un label d'option, sans distinction de casse. Toujours renvoyée sous forme de clé d'option |

- Envoyez `null` pour une clé afin d'effacer sa valeur.
- Les clés absentes de la requête ne changent pas. `{}`, ou l'absence de `custom_attributes`, ne change rien.
- Une clé inconnue ou archivée renvoie `400 CUSTOM_ATTRIBUTE_KEY_UNKNOWN`. Une valeur du mauvais type renvoie `400 CUSTOM_ATTRIBUTE_VALUE_INVALID`. Dans les deux cas, `param` vaut `custom_attributes.<key>`.
- La requête entière est validée avant toute écriture : une requête rejetée ne crée rien.
- La réponse inclut toujours `custom_attributes`, `{}` si l'entreprise n'en a pas. Les attributs archivés et les valeurs vides sont omis.
- Les valeurs sont aussi synchronisées vers vos HubSpot et Attio connectés. Une valeur d'un attribut synchronisé depuis un CRM peut être écrasée par la prochaine synchronisation du CRM.
- Les équipes sur l'ancien modèle de contacts reçoivent `404 TEAM_NOT_FOUND`.

### Exemple

Le label `Advanced` de la liste déroulante est stocké et renvoyé sous sa clé `advanced`. Les autres champs de l'entreprise sont omis de la réponse ci-dessous.

```json
{
  "name": "Acme Corp",
  "custom_attributes": {
    "ping_pong_level": "Advanced",
    "renewal_date": "2026-12-01"
  }
}
```

```json
{
  "data": {
    "id": "com-xyz789",
    "name": "Acme Corp",
    "custom_attributes": {
      "ping_pong_level": "advanced",
      "renewal_date": "2026-12-01"
    }
  }
}
```
