Créer ou retrouver une entreprise par API
POST/companies
Créer ou retrouver une entreprise. Crée ou réutilise une entreprise, sans apprenant et sans inscription. name, email et address sont obligatoires. Sans téléphone, une chaîne vide est enregistrée. Le SIRET est facultatif ici. Aucun identifiant de connexion ni mot de passe entreprise n’est généré.
Permission : companies:create. Les deux jetons restent obligatoires.
Champs de la requête
| Champ | Obligatoire | Null autorisé | Type, limites, valeurs et défaut |
|---|---|---|---|
name |
Oui | Non | string ; 255 caractères max. ; 1020 octets max. |
email |
Oui | Non | string / email ; 255 caractères max. ; 1020 octets max. |
phone |
Non | Non | string ; 255 caractères max. ; 1020 octets max. ; défaut "" |
address |
Oui | Non | string ; 255 caractères max. ; 1020 octets max. |
siret |
Non | Oui | string / siret ; 255 caractères max. ; 1020 octets max. |
tva |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
ape |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
description |
Non | Oui | string ; 16000 caractères max. ; 64000 octets max. |
represented_by |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
function_represented_by |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
title_represented_by |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
opco |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
adherent |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
effectif |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
idcc |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
nace |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
email2 |
Non | Oui | string / email ; 255 caractères max. ; 1020 octets max. |
contact2 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
email3 |
Non | Oui | string / email ; 255 caractères max. ; 1020 octets max. |
contact3 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
email4 |
Non | Oui | string / email ; 255 caractères max. ; 1020 octets max. |
contact4 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
email5 |
Non | Oui | string / email ; 255 caractères max. ; 1020 octets max. |
contact5 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
civilite2 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
civilite3 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
civilite4 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
civilite5 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
phone2 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
phone3 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
phone4 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
phone5 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
fonction2 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
fonction3 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
fonction4 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
fonction5 |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
code_postal |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
street |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
city |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
country_code |
Non | Oui | string ; 255 caractères max. ; 1020 octets max. |
Exemple de requête JSON
{
"name": "Entreprise Exemple",
"email": "office@example.com",
"address": "10 rue Exemple",
"siret": "12345678900010"
}
Exemple de réponse
{
"success": true,
"request_id": "req_0123456789abcdef0123456789abcdef",
"data": {
"company_id": "301",
"company_status": "created"
}
}