---
title: "🔒 Создание нового пользователя (черновика)."
method: POST
path: "/user/create"
tags: ["Users"]
---

# 🔒 Создание нового пользователя (черновика).

`POST /user/create`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/user/create`
- Auth: one of:
  - API key in header `sid` and API key in header `rts` and API key in header `sig`
  - HTTP bearer

Создание нового пользователя (черновика).

**Access:** `authorized` (10 ) · **Scope:** `write`

**Allows:** `user:create` (все обязательны; без ресурса)

### TypeScript (copy-paste)

**`POST /user/create`**

<details open><summary><b>Body (Partial)</b></summary>

```typescript
// Patch-body: все поля опциональны (Valid.Patch)
export type UserCreateBody = Partial<Resp_user_create>

export interface UserCreateBodyFields {
  ID?: string
  /** Phone number */
  phone?: string | null
  email?: string | null
  auth?: Record<string, any> | null
  avatarFID?: string
  firstName?: string
  lastName?: string
  patronymic?: string | null
  gender?: User_gender | null
  contactInfo?: string | null
  dateOfBirth?: string | null
  address?: {
  country?: string | null
  city?: string | null
  streetAddress?: string | null
} | null
  timeZone?: string | null
  meetingInfo?: {
  zoomEmail?: string | null
} | null
  position?: string | null
  hourCost?: number
  docsEmployment?: Record<string, any> | null
  docsLibrary?: Record<string, any> | null
  isDraft?: boolean
  createDT?: string
  createdUID?: string
  /** Unix timestamp in milliseconds */
  updTS?: number
  updUID?: string
}
```

</details>

<details open><summary><b>Response</b></summary>

```typescript
export type UserCreateResponse = IServerResponse<Resp_user_create>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
```

</details>

> Полный файл типов: [`/docs/types`](/docs/types) · raw: [`/docs/api-types.ts`](/docs/api-types.ts)

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required
- `rKey` string

## Request body

- UserCreateBody: Partial body (Valid.Patch) for `user/create` — все поля опциональны
  - `ID` string, uuid
  - `phone` string, nullable: Phone number
  - `email` string, nullable
  - `auth` object, nullable
  - `avatarFID` string, uuid
  - `firstName` string
  - `lastName` string
  - `patronymic` string, nullable
  - `gender` 'male' | 'female': `male` = "male", `female` = "female"
  - `contactInfo` string, nullable
  - `dateOfBirth` string, date-time, nullable
  - `address` object, nullable
    - `country` string, nullable
    - `city` string, nullable
    - `streetAddress` string, nullable
  - `timeZone` string, nullable
  - `meetingInfo` object, nullable
    - `zoomEmail` string, nullable
  - `position` string, nullable
  - `hourCost` number
  - `docsEmployment` object, nullable
  - `docsLibrary` object, nullable
  - `isDraft` boolean
  - `createDT` string, date-time
  - `createdUID` string
  - `updTS` integer: Unix timestamp in milliseconds
  - `updUID` string

## Response `200`

OK — `IServerResponse<Resp_user_create>`

- object
  - `code` integer, required
  - `data` RespUserCreate, required: ResponseData for user/create
    - `user` User, required: Entity `User` (table: User )
      - `ID` string, uuid, required
      - `phone` string, nullable: Phone number
      - `email` string, nullable
      - `auth` object, nullable
      - `avatarFID` string, uuid, required
      - `firstName` string, required
      - `lastName` string, required
      - `patronymic` string, nullable
      - `gender` 'male' | 'female': `male` = "male", `female` = "female"
      - `contactInfo` string, nullable
      - `dateOfBirth` string, date-time, nullable
      - `address` object, nullable
        - `country` string, nullable
        - `city` string, nullable
        - `streetAddress` string, nullable
      - `timeZone` string, nullable
      - `meetingInfo` object, nullable
        - `zoomEmail` string, nullable
      - `position` string, nullable
      - `hourCost` number, required
      - `docsEmployment` object, nullable
      - `docsLibrary` object, nullable
      - `isDraft` boolean, required
      - `createDT` string, date-time, required
      - `createdUID` string, required
      - `updTS` integer, required: Unix timestamp in milliseconds
      - `updUID` string, required
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest: Required fields (phone or email) are missing in request body
- `401`: Unauthorized: Active user session required
- `403`: AccessNotAllowed — privilegeRequired: нет привилегии; data.params = { code: 'privilegeRequired', allow, relation? }
- `406`: TimeResync — расхождение rts с сервером
- `422`: UnprocessableContent: User with provided ID, phone number or email already exists in system

---

[API](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api.md) · [All operations](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/revisions/a143b51ba29a?raw)
