VisioFormation · APIConnecter vos outils, conserver le contrôle

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"
  }
}