---
title: "Create User"
method: POST
path: "/v1/users"
tags: ["Users"]
---

# Create User

`POST /v1/users`

Creates a new user and adds them to the authenticated account. Licenses are automatically assigned to the new user based on the account's auto-licensing configuration. Only available to Enterprise accounts.

## Request body

- CreateUserBody
  - `email` string, required — The user's email.
  - `firstName` string, required — The user's first name.
  - `lastName` string, required — The user's last name.
  - `username` string — The user's username. If not provided the email will be used as the username.
  - `password` string — The user's password.
  - `roles` UserRole[] — A list of roles assigned to the user.

## Response `201`

Created. Returns a User resource containing information about the created user.

- User — A standard representation of a user.
  - `accountId` number — The unique ID for the user's account.
  - `enabled` boolean — Whether the user can authenticate to Lucid. Corresponds to the SCIM active attribute.
  - `email` string — The user's email.
  - `name` string — The user's full name.
  - `userId` number — The unique ID for the user.
  - `username` string — The user's username.
  - `roles` UserRole[] — A list of administrative roles assigned to the user.
  - `avatar` Avatar — A reference to a user's avatar image. When the user has no uploaded avatar, this falls back to their Gravatar image.
    - `type` 'url', required — The kind of avatar. Currently always `url`, indicating the avatar is referenced by a link. Additional avatar kinds may be introduced in the future.
    - `link` string, required — A URL pointing to the user's avatar image.

## Other responses

- `400` — Bad Request. Occurs if any input field is invalid.
- `403` — Forbidden. Occurs if the app making the request does not have permission to create users, if the email domain is under domain control by a different account, or if the token requesting to create a user is not on an Enterprise account.
- `409` — Conflict. Occurs if a user with the same email or username already exists.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)