---
title: "Create a new user."
method: POST
path: "/api/user-management"
tags: ["UserManagement"]
---

# Create a new user.

`POST /api/user-management`

## Request body

- CreateUserDto
  - `email` string, required — The email of the user. Unique value.
  - `displayName` string, required — The display name (usually first name and last name) of the user.
  - `password` string, required — The password of the user.
  - `permissions` string[], required — Additional permissions for the user.

## Response `201`

User created.

- UserDto
  - `_links` object, required — The links.
  - `id` string, required — The ID of the user.
  - `email` string, required — The email of the user. Unique value.
  - `displayName` string, required — The display name (usually first name and last name) of the user.
  - `isLocked` boolean, required — Determines if the user is locked.
  - `permissions` string[], required — Additional permissions for the user.

## Other responses

- `400` — User request not valid.
- `500` — Operation failed.

---

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