---
title: "Create a user"
method: POST
path: "/users/"
tags: ["User"]
---

# Create a user

`POST /users/`

Create a user in the caller's (or specified) tenant and send a confirmation email.

## Query parameters

- `cookie_name` string, nullable
- `tenant_id` integer

## Request body

- UserIn
  - `first_name` string, required — User's given name.
  - `last_name` string, required — User's family name.
  - `email` string, email, required — Email address used to log in; must be unique.
  - `password` string, required — Initial password; the user is prompted to change it on first login.
  - `admin` boolean, nullable — Whether the user has tenant administrator privileges.
  - `superadmin` boolean, nullable — Whether the user is a platform operator; requires superadmin to set.
  - `tenant_id` integer, nullable — Tenant to create the user in; defaults to the caller's tenant.

## Response `201`

Successful Response

- UserOut
  - `id` integer, required — Unique identifier of the user.
  - `created_at` string, date-time, required — UTC timestamp when the user was created.
  - `email` string, email, required — Current confirmed email address.
  - `email_confirmed` boolean, required — Whether the email address has been confirmed.
  - `pending_email` string, nullable — New email awaiting confirmation, or null if none pending.
  - `name` string, nullable — Full display name, if set.
  - `first_name` string, nullable — User's given name.
  - `last_name` string, nullable — User's family name.
  - `admin` boolean, required — Whether the user has tenant administrator privileges.
  - `superadmin` boolean, nullable — Whether the user is a platform operator.
  - `active` boolean, required — Whether the account is active and can authenticate.
  - `tenant_id` integer, nullable — Identifier of the tenant the user belongs to.

## Other responses

- `401` — Missing or invalid authentication.
- `403` — Administrator privileges required for the target tenant or flags.
- `422` — Validation Error

---

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