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. 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
nullpour une clé afin d'effacer sa valeur. - Les clés absentes de la requête ne changent pas.
{}, ou l'absence decustom_attributes, ne change rien. - Une clé inconnue ou archivée renvoie
400 CUSTOM_ATTRIBUTE_KEY_UNKNOWN. Une valeur du mauvais type renvoie400 CUSTOM_ATTRIBUTE_VALUE_INVALID. Dans les deux cas,paramvautcustom_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.
{
"name": "Acme Corp",
"custom_attributes": {
"ping_pong_level": "Advanced",
"renewal_date": "2026-12-01"
}
}
{
"data": {
"id": "com-xyz789",
"name": "Acme Corp",
"custom_attributes": {
"ping_pong_level": "advanced",
"renewal_date": "2026-12-01"
}
}
}