---
title: "Create a new user"
method: POST
path: "/v2/users"
tags: ["Users"]
---

# Create a new user

`POST /v2/users`

Creates a new user.

To enable the user to access an account, they must be assigned at least one role. A user will not be sent an email invite until assigned at least one role.

Follow these steps to create and configure a user: 

1. **Create user:** Create the user by calling  `POST /users`.

2. **Get role(s):** Use `GET /roles` to fetch the role_identifier(s) you wish to assign to the user.

3. **(Optional) Get account**: If you need to assign roles for an account you're not currently logged into but within the same organization, retrieve the relevant `account_identifier` using `GET clients/me/accounts`.

4. **Assign user role**: Use `POST /users/{user_identifier}/roles` to assign the user to an account with a list of `role_identifier(s)` and optionally the `account_identifier` if applicable.


You need the "Create and update users" permission to use this endpoint.

## Request body

- IdentityUserRequestBody
  - `email` string, email, required — Email address of the user.
  - `name` string, required — Full name of the user.

## Response `201`

CREATED

- IdentityAnyUserResponse
  - `active` boolean, required — If a user is active or deactivated.
  - `client_identifier` string, uuid, required — The unique identifier of the client.
  - `created_at` string, date-time, required — Date and time the user was created.
  - `created_by` string, uuid, required — The unique identifier of who created the user.
  - `deactivated_at` string, date-time — Date and time the user was deactivated.
  - `email` string, required — Email address of the user.
  - `enforce_mfa_after` string, date-time — Date and time of when MFA will be enforced for the user.
  - `identifier` string, uuid, required — The unique identifier of the user.
  - `name` string, required — Full name of the user.
  - `updated_at` string, date-time, required — Date and time the user was last updated.
  - `updated_by` string, uuid, required — The unique identifier of who last updated the user.
  - `user_type` 'AGENT' | 'HUMAN' | 'MACHINE_CREDENTIAL', required — Specifies the type of the entity.

## Other responses

- `400` — Invalid input

---

[API](https://skmtc.dev/complyadvantage/apis/mesh-api.md) · [All operations](https://skmtc.dev/complyadvantage/apis/mesh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/complyadvantage/mesh-api/revisions/fdaac4351d85/schema)