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

# Create a User

`POST /v1/users`

Use this endpoint to create a user access and assign it to a permission group in a single step.

## Request body

- UserInput — Information about the user.
  - `email` string, required — User's email address.
  - `firstName` string, required — User's first name.
  - `groups` string[] — Array of user role groups IDs. Role groups IDs can be retrieved through the List Groups endpoint.
  - `lastName` string, required — User's last name.
  - `password` string, required — User's password for authentication.
  - `username` string, required — User's username.

## Response `201`

Indicates that the resource was successfully created and the operation was completed as expected.

- UserResponse — The identity details for a user, including basic info and groups.
  - `email` string — User’s email address.
  - `firstName` string — User’s first name.
  - `groups` string[] — List of groups the user belongs to.
  - `id` string — Unique identifier of the user.
  - `lastName` string — User’s last name.
  - `username` string — Unique username.

## Other responses

- `400`
- `500`

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)