---
title: "Add a new user"
method: POST
path: "/users/"
tags: ["users"]
---

# Add a new user

`POST /users/`

Use this method to add a new user.

## Request body

- UserRequest
  - `active` boolean, required
  - `groups` integer[]
  - `password` string, required
  - `real_name` string, required
  - `name` string, required
  - `comment` string — Extended description of the user, up to 2048 chars
  - `primary_group` integer, required
  - `language` 'en-us' | 'es' | 'ru'
  - `face_cover` string, nullable

## Response `201`

- User
  - `id` integer, required
  - `active` boolean, required
  - `created_date` string, date-time, required
  - `groups` integer[]
  - `modified_date` string, date-time, required — Object modification date
  - `permissions` string[], required
  - `real_name` string, required
  - `name` string, required
  - `comment` string — Extended description of the user, up to 2048 chars
  - `camera_group_permissions` object, required
  - `watch_list_permissions` object, required
  - `group_permissions` object, required
  - `primary_group` integer, required
  - `language` 'en-us' | 'es' | 'ru'
  - `has_face` boolean, required — User photo is provided
  - `face_cover` string, nullable
  - `ad_user` boolean, required — User is registered in Active Directory

---

[API](https://skmtc.dev/ntechlab/apis/internal-api-documentation.md) · [All operations](https://skmtc.dev/ntechlab/apis/internal-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ntechlab/internal-api-documentation/revisions/fe217a895bc7/schema)