---
title: "POST /api/v4/users"
method: POST
path: "/api/v4/users"
---

# POST /api/v4/users

`POST /api/v4/users`

Create users (batch).

## Request body

- UserCreateItem[]
  - `name` string, required
  - `email` string, required
  - `password` string, required
  - `lang` string
  - `rights` UserRights
    - `leads` object
    - `contacts` object
    - `companies` object
    - `tasks` object
    - `mail_access` boolean
    - `catalog_access` boolean
    - `is_admin` boolean
    - `is_free` boolean
    - `is_active` boolean
    - `group_id` integer, nullable
    - `role_id` integer, nullable
    - `status_rights` StatusRight[], nullable
      - `entity_type` string
      - `pipeline_id` integer
      - `status_id` integer
      - `rights` object
  - `request_id` string

## Response `200`

The request has succeeded.

- union
  - UserCreateResponse
    - `_total_items` integer
    - `_links` object
    - `_embedded` object
      - `users` UserCreateResult[]
        - `id` integer
        - `name` string
        - `email` string
        - `lang` string
        - `rights` UserRights
          - `leads` object
          - `contacts` object
          - `companies` object
          - `tasks` object
          - `mail_access` boolean
          - `catalog_access` boolean
          - `is_admin` boolean
          - `is_free` boolean
          - `is_active` boolean
          - `group_id` integer, nullable
          - `role_id` integer, nullable
          - `status_rights` StatusRight[], nullable
            - `entity_type` string
            - `pipeline_id` integer
            - `status_id` integer
            - `rights` object
        - `uuid` string, nullable
        - `amojo_id` string, nullable
        - `user_rank` string, nullable
        - `phone_number` string, nullable
        - `_links` object
        - `_embedded` UserEmbedded
          - `roles` Role[]
            - `id` integer
            - `name` string
            - `rights` UserRights
              - …
            - `_links` object
            - `_embedded` RoleEmbedded
              - …
          - `groups` UsersGroup[]
            - `id` integer
            - `name` string
            - `uuid` string
  - Problem
    - `title` string
    - `status` integer
    - `detail` string
    - `type` string

---

[API](https://skmtc.net/hexlet/apis/amocrm-api.md) · [All operations](https://skmtc.net/hexlet/apis/amocrm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hexlet/amocrm-api/versions/800f4ed7083b/schema)