Passer au contenu principal
POST
Create company
Scope requis : CRM_WRITE

Champs du body

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.
  • 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.

Autorisations

Authorization
string
header
requis

Corps

application/json

Request body for creating a company

name
string
requis

Company name

Exemple:

"Acme Corp"

website
string | null

Company website URL

Exemple:

"https://acme.com"

industry
string | null

Industry sector

Exemple:

"Technology"

custom_attributes
object | null

Values for the company's custom attributes, keyed by attribute key. TEXT takes a string, NUMBER a finite JSON number (numeric strings are rejected), BOOLEAN a JSON boolean, DATE a YYYY-MM-DD string or ISO datetime, and DROPDOWN an option key or label (case-insensitive). Send null to clear a value; keys you omit are left untouched, and {} or omitting the field changes nothing. An unknown or archived key, or a value of the wrong type, rejects the whole request with CUSTOM_ATTRIBUTE_KEY_UNKNOWN or CUSTOM_ATTRIBUTE_VALUE_INVALID.

Exemple:

Réponse

Company created

data
object

A company in the CRM