Aller au contenu principal

Créer un tiers

Créer un tiers — POST​

Personne physique (type = PERSON)​

Champs requis : email (contrainte d'unicité)

curl --location 'https://api.stonal.io/datalake/v1/organizations/$organization/stakeholders' \
--header 'Authorization: Bearer $token' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type": "person",
  "firstName": "John",
  "lastName": "Doe",
  "address": "string",
  "postalCode": "string",
  "city": "string",
  "externalCode": "string",
  "contactsDetails": [
    {
      "email": "john.doe@example.com",
      "phoneNumber": "0123456789",
      "additionalInfos": "string"
    }
  ],
  "isActive": true,
  "fax": "string",
  "function": "string"
}'

Entité juridique (type = COMPANY)​

Champs requis : siren et companyName (contrainte d'unicité)

curl --location 'https://api.stonal.io/datalake/v1/organizations/$organization/stakeholders' \
--header 'Authorization: Bearer $token' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type": "company",
  "companyName": "Acme Corporation",
  "siren": 123456789,
  "address": "string",
  "postalCode": "string",
  "city": "string",
  "externalCode": "string",
  "contactsDetails": [
    {
      "email": "john.doe@example.com",
      "phoneNumber": "0123456789",
      "additionalInfos": "string"
    }
  ],
  "isActive": true,
  "fax": "string",
  "function": "string"
}'

Réponse​

Une création réussie renvoie un statut HTTP 201 avec l'uid du tiers créé.