Skip to main content

Create a user

Use this example to create a user with a raw Administration API request.

Before you begin, authenticate the Admin API application and obtain an auth token.

The Admin API application requires the USERS:ADD permission. Submit a request to create a user.

  • Method: POST
  • Path: /api/web/v3/users
  • Content type: application/json

Example request header​

Authorization: Bearer <auth-token>

Example request body​

userId is always required. Include any additional fields configured as mandatory for the account:

{
  "firstName": "John",
  "lastName": "Smith",
  "email": "johnsmith@organization.com",
  "userId": "john",
  "mobile": "+16138561234",
  "state": "ACTIVE"
}

Example response body​

HTTP 200 returns the created user's details. Fields that are not relevant to the example are omitted:

{
  "id": "2c422a2f-e8ae-4af8-8b03-e1ce0ddde0b0",
  "userId": "john",
  "firstName": "John",
  "lastName": "Smith",
  "email": "johnsmith@organization.com",
  "mobile": "+16138561234",
  "state": "ACTIVE",
  "locked": false,
  "grids": [],
  "tokens": [],
  "groups": []
}

The returned collections depend on account configuration and resources assigned during user creation. For all supported fields and error responses, see Create a user.