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

# Create a user

`POST /users`

## Request

- Base URL: `https://orbitus.netcorecloud.com`
- URL: `https://orbitus.netcorecloud.com/users`
- Auth: HTTP bearer

Requires admin role.

## Request body

- UserCreate
  - `username` string, required
  - `email` string, email, required
  - `password` string, password, required
  - `role` 'admin' | 'viewer', required
  - `allowed_subclient_ids` integer[]: Sub-client IDs this user may access.

## Response `201`

User created.

- UserProfile
  - `id` integer
  - `username` string
  - `email` string, email
  - `full_name` string
  - `role` 'admin' | 'viewer'
  - `client_id` integer
  - `two_factor_enabled` boolean

## Other responses

- `400`: Validation error.

---

[API](https://skmtc.dev/netcorecloud/apis/orbit-router.md) - [All operations](https://skmtc.dev/netcorecloud/apis/orbit-router/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/orbit-router/revisions/680f0a8ab1a3?raw)