API ReferenceManagementUsers
POST
/v1/mgmt/user/create/batch

Batch Create Users, using a valid management key.

This API endpoint will batch create new users utilizing a valid management key.

This API endpoint allows you to configure all aspects of a user:

  • loginId
  • email
  • phone
  • verified settings (phone, email) - one must be set to true
  • displayName
  • roleNames
  • Tenant configurations - which tenantIds, which roleNames. The userTenants can include multiple items Ex:
"userTenants": [
{
  "tenantId": "T2IMjmRfYTQHlbaastz3im59ERS3",
  "roleNames": [
    "Test"
  ]
},
{
  "tenantId": "T2Igau6dX1R6SkomtFCdBLrc3r67",
  "roleNames": [
    "Test"
  ]
}

Additionally, you can create a user with multiple login IDs by passing an array of loginIds in string format within the additionalIdentifiers key.

You can also decide whether to invite the users, configure the inviteUrl, and whether to send invites via email or SMS.

When importing with hashed passwords, see this guide for further detailed configuration of password hash formats.

Next Steps

Once the user is created, the user can then login utilizing any sign-in api supported. This will then switch the user from invited to active.

See also

Endpoint Authentication

Use authorization bearer header with the following format:

Authorization: Bearer \<ProjectId:ManagementKey\>

Try it

/v1/mgmt/user/create/batch

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

< Project ID >:< Management Key > as bearer

In: header

Request Body

usersarray<object>

inviteboolean

sendMailboolean

sendSMSboolean

inviteUrlstring

templateOptionsobject

Status codeDescription
200OK
curl -X POST "https://api.descope.com/v1/mgmt/user/create/batch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ProjectId:ManagementKey>" \
  -d '{
  "users": [
    {
      "loginId": "string",
      "email": "string",
      "phone": "string",
      "verifiedEmail": true,
      "verifiedPhone": true,
      "name": "string",
      "roleNames": [
        "string"
      ],
      "userTenants": [
        {
          "tenantId": "string",
          "roleNames": [
            "string"
          ]
        }
      ],
      "test": false,
      "picture": "string",
      "customAttributes": {},
      "password": "string",
      "hashedPassword": {
        "bcrypt": {
          "hash": "string"
        },
        "django": {
          "hash": "string"
        },
        "firebase": {
          "hash": "string",
          "salt": "string",
          "saltSeparator": "string",
          "signerKey": "string",
          "memory": 0,
          "rounds": 0
        },
        "pbkdf2": {
          "hash": "string",
          "salt": "string",
          "iterations": 0,
          "type": "string"
        },
        "phpass": {
          "hash": "string",
          "salt": "string",
          "iterations": 0,
          "type": "string"
        },
        "md5": {
          "hash": "string"
        }
      },
      "additionalIdentifiers": [
        "string"
      ],
      "givenName": "string",
      "middleName": "string",
      "familyName": "string",
      "ssoAppIds": [
        "string"
      ],
      "seed": "string"
    }
  ],
  "invite": true,
  "sendMail": true,
  "sendSMS": true,
  "inviteUrl": "string",
  "templateOptions": {
    "property1": "string",
    "property2": "string"
  }
}'

{
  "createdUsers": [
    {
      "loginIds": [
        "string"
      ],
      "userId": "string",
      "name": "string",
      "email": "string",
      "phone": "string",
      "verifiedEmail": true,
      "verifiedPhone": true,
      "roleNames": [
        "string"
      ],
      "userTenants": [
        {
          "tenantId": "string",
          "roleNames": [
            "string"
          ],
          "tenantName": "string"
        }
      ],
      "status": "string",
      "externalIds": [
        "string"
      ],
      "picture": "string",
      "test": false,
      "customAttributes": {},
      "createdTime": 0,
      "TOTP": false,
      "SAML": false,
      "OAuth": {
        "property1": false,
        "property2": false
      },
      "webauthn": true,
      "password": true,
      "ssoAppIds": [
        "string"
      ],
      "givenName": "string",
      "middleName": "string",
      "familyName": "string",
      "editable": true
    }
  ],
  "failedUsers": [
    {
      "failure": "string",
      "user": {
        "loginIds": [
          "string"
        ],
        "userId": "string",
        "name": "string",
        "email": "string",
        "phone": "string",
        "verifiedEmail": true,
        "verifiedPhone": true,
        "roleNames": [
          "string"
        ],
        "userTenants": [
          {
            "tenantId": "string",
            "roleNames": [
              "string"
            ],
            "tenantName": "string"
          }
        ],
        "status": "string",
        "externalIds": [
          "string"
        ],
        "picture": "string",
        "test": false,
        "customAttributes": {},
        "createdTime": 0,
        "TOTP": false,
        "SAML": false,
        "OAuth": {
          "property1": false,
          "property2": false
        },
        "webauthn": true,
        "password": true,
        "ssoAppIds": [
          "string"
        ],
        "givenName": "string",
        "middleName": "string",
        "familyName": "string",
        "editable": true
      }
    }
  ],
  "additionalErrors": {
    "property1": "string",
    "property2": "string"
  }
}

Was this helpful?

Previous

Create User

Next

Patch User