Create eSignature user

POST

/v2/organizations/:organizationId/users

POST

/Management/v2/organizations/:organizationId/users

curl -X POST https://api-d.docusign.net/Management/v2/organizations/organizationId/users \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "accounts": [
    {
      "id": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "email": "string"
}'

200Successful

{
  "id": "00000000-0000-0000-0000-000000000000",
  "site_id": 1,
  "user_name": "string",
  "first_name": "string",
  "last_name": "string",
  "email": "string",
  "language_culture": "string",
  "federated_status": "string",
  "accounts": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "site_id": 1,
      "permission_profile": {
        "id": 1,
        "name": "string"
      },
      "groups": [
        {
          "id": 1,
          "name": "string",
          "type": "string"
        }
      ],
      "company_name": "string",
      "job_title": "string",
      "license_status": "string",
      "license_type": "string",
      "plan_name": "string",
      "subscription_id": "string"
    }
  ]
}

Creates a new eSignature user and automatically activates the user’s account.

Required authentication scopes: user_write.

How to create a new active eSignature user

Authentication

AuthorizationBearer

OAuth2 Access code Grant

Path parameters

organizationIdstringRequiredformat: "uuid"

The organization ID Guid

Request

This endpoint expects an object: request

accountslist of objectsRequired

A list of accounts the user will belong to.

emailstringRequired

The email address.

user_namestringOptional

The full name of the user.

first_namestringOptional

The user's first name.

last_namestringOptional

The user's last name.

default_account_idstringOptionalformat: "uuid"

The account ID of the user's default account.

language_culturestringOptional

The language and culture of the user.

Chinese Simplified: zh_CN
Chinese Traditional: zh_TW
Dutch: nl
English: en
French: fr
German: de
Italian: it
Japanese: ja
Korean: ko
Portuguese: pt
Portuguese Brazil: pt_BR
Russian: ru
Spanish: es

selected_languagesstringOptional

access_codestringOptional

The access code that the user needs to activate an account.

federated_statusstringOptional

The user’s federated status. One of:

RemoveStatus
FedAuthRequired
FedAuthBypass
Evicted

auto_activate_membershipsbooleanOptional

When true, the user’s account is activated automatically.

Response

idstringOptionalformat: "uuid"

The ID of the added user

site_idintegerOptional

The site ID of the added user.