> For AI agents: [llms.txt](https://docs.trustedauth.com/llms.txt) provides a Markdown index of this documentation.

# Create a user

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

Before you begin, [authenticate the Admin API application](/api/admin-api/rest-examples/authentication/authenticate-admin-application.md) 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

```text
Authorization: Bearer <auth-token>
```

## Example request body

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

```json
{
  "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:

```json
{
  "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](/api/openapi/admin-api/create-user-using-post.md).