Créer un utilisateur

POST

https://workflow-manager/api/tenants/:tenantId/users

POST

/api/tenants/:tenantId/users

curl -X POST https://workflow-manager/api/tenants/tenantId/users \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "groupId": "grp_BTsBTqgZuePSmmPz5ynWM2nN",
  "email": "gertude.bergstrom8663@my-company.com",
  "firstName": "Ambre",
  "lastName": "Leclercq",
  "isDisabled": false,
  "picture": "data:image/gif;base64,R0lGODlhEAAQAMQAAORHHOVSKudfOulrSOp3WOyDZu6QdvCchPGolfO0o/XBs/fNwfjZ0frl3/zy7////wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA...",
  "phoneNumber": "+33 6 12 34 56 78",
  "comments": "Molestiae fugit expedita expedita illum.",
  "country": "FR",
  "organizationTitles": [
    {
      "organizationId": "org_i3niMbz4WCYkMgYe9y7KnHgv",
      "title": "Corporate Optimization Consultant"
    }
  ],
  "subject": "c73964fe-26a4-4434-a6b3-91dfcee74386"
}'

{
  "approveAllowed": true,
  "comanageAllowed": true,
  "country": "FR",
  "created": 1782821445591,
  "email": "gertude.bergstrom8663@my-company.com",
  "firstName": "Ambre",
  "groupId": "grp_BTsBTqgZuePSmmPz5ynWM2nN",
  "id": "usr_LqVk5fa8mxFccrfBRAi433Ry",
  "isDisabled": false,
  "lastLogin": 0,
  "lastName": "Leclercq",
  "name": "Ambre Leclercq",
  "organizationTitles": [
    {
      "organizationId": "org_i3niMbz4WCYkMgYe9y7KnHgv",
      "title": "Corporate Optimization Consultant"
    }
  ],
  "phoneNumber": "+33 6 12 34 56 78",
  "signAllowed": true,
  "tenantId": "ten_Hm5gqY6oKADYdg9cjhsVbQDH",
  "updated": 1782821445591,
  "viewAuthorizedGroups": [
    "grp_BTsBTqgZuePSmmPz5ynWM2nN",
    "grp_ExUUECizVJs8KVq7nCwhwMR1"
  ],
  "comments": "Molestiae fugit expedita expedita illum.",
  "pictureResourceId": "res_29345uEn4EnifpQHEzcCVEDb",
  "subject": "c73964fe-26a4-4434-a6b3-91dfcee74386",
  "userGroupedInvitationsMode": true,
  "onboardingEmailSent": false
}

Crée un nouvel utilisateur dans le tenant. Si un utilisateur avec la même adresse email existe déjà, l’utilisateur existant est renvoyé (création idempotente).

Rôle requis

userManager

Également autorisés sans rôle : les membres d’un groupe autorisé.

Authentification

AuthorizationBearer

Authentification Bearer par jeton utilisateur ou jeton d’accès : Authorization: Bearer <token>.

Paramètres de chemin

tenantIdstringRequis

L'identifiant du tenant.

Requête

This endpoint expects an object.

groupIdstringRequis

L'identifiant du groupe auquel appartient l'utilisateur.

emailstringRequis

L'adresse email de l'utilisateur.

firstNamestringRequis

Le prénom de l’utilisateur.

lastNamestringRequis

Le nom de l'utilisateur.

isDisabledbooleanOptionnel

Indique si l’utilisateur est désactivé.

picturestringOptionnel

La photo de l'utilisateur, sous forme d'URL ou de data URI.

phoneNumberstringOptionnel

Le numéro de téléphone international de l’utilisateur.

commentsstringOptionnel

Les commentaires associés au contact.

countrystringOptionnel

Le pays de l'utilisateur.

organizationTitleslist of objectsOptionnel

Les titres d'organisation de l'utilisateur.

subjectstringOptionnel

L’identifiant de l’utilisateur dans la base externe du fournisseur d’identité.

Réponse

L’entité User créée.

approveAllowedboolean

Indique si l’utilisateur est autorisé à valider des parapheurs.

comanageAllowedboolean

Indique si l’utilisateur est autorisé à cogérer des parapheurs.

countrystring

Le pays de l'utilisateur.

createdlong

La date de création de l’entité.

emailstring

L'adresse email de l'utilisateur.

firstNamestring

Le prénom de l’utilisateur.

groupIdstring

L'identifiant du groupe auquel appartient l'utilisateur.

idstring

L'identifiant de l'utilisateur.

isDisabledboolean

Indique si l’utilisateur est désactivé.

lastLoginlong

La date de la dernière création de jeton de connexion pour l’utilisateur.

lastNamestring

Le nom de l'utilisateur.

namestring

Le nom complet de l'utilisateur.

organizationTitleslist of objects

Les titres d'organisation de l'utilisateur.

phoneNumberstring

Le numéro de téléphone international de l’utilisateur.

signAllowedboolean

Indique si l’utilisateur est autorisé à signer des parapheurs.

tenantIdstring

L'identifiant du tenant auquel appartient l'utilisateur.

updatedlong

La date de dernière modification de l’entité.

viewAuthorizedGroupslist of strings

La liste des identifiants de groupes dont les membres peuvent consulter cet utilisateur.

commentsstringOptionnel

Les commentaires associés au contact.

pictureResourceIdstringOptionnel

L'identifiant de la ressource photo de l'utilisateur.

subjectstringOptionnel

L’identifiant de l’utilisateur dans la base externe du fournisseur d’identité.

userGroupedInvitationsModebooleanOptionnel

Indique si l’utilisateur souhaite recevoir des notifications groupées selon les réglages du groupe.

onboardingEmailSentbooleanOptionnel

Indique si l’email d’accueil (onboarding) a été envoyé à l’utilisateur lors de sa première connexion.

jobOperationstringOptionnel

L’opération de tâche en cours d’exécution.

Erreurs

400

Bad Request Error

403

Forbidden Error

404

Not Found Error