---
title: "Adicionando usuários"
method: POST
path: "/api/v4/users"
---

# Adicionando usuários

`POST /api/v4/users`

Este método permite adicionar vários usuários à conta.

## Headers

- `Content-Type` string

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string, required — Nome completo do usuário. O valor não deve conter símbolos especiais (exceto .@-_), consistir em espaços ou conter links. Não deve ter mais de 50 caracteres.
    - `email` string, required — E-mail do usuário
    - `password` string, required — Senha do usuário. Deve ter pelo menos 6 caracteres e conter pelo menos 1 dígito, uma letra maiúscula e uma letra minúscula.
    - `lang` string — Idioma do usuário. Um dos seguintes: ru, en, es, pt. Por padrão, é o idioma da conta (ru, en, es ou pt).
    - `rights` object — Direitos do usuário. O campo não é obrigatório; por padrão, todo o acesso é restrito.
      - `leads` object — Objeto de direitos de acesso a leads. O campo é obrigatório se o “role_id” não for passado e o sinalizador “is_free” não estiver definido.
        - `view` 'A' | 'G' | 'M' | 'D'
        - `edit` 'A' | 'G' | 'M' | 'D'
        - `add` 'A' | 'G' | 'M' | 'D'
        - `delete` 'A' | 'G' | 'M' | 'D'
        - `export` 'A' | 'G' | 'M' | 'D'
      - `contacts` object — Objeto de direitos de acesso a contatos. O campo é obrigatório se o “role_id” não for passado e o sinalizador “is_free” não estiver definido.
        - `view` 'A' | 'G' | 'M' | 'D'
        - `edit` 'A' | 'G' | 'M' | 'D'
        - `add` 'A' | 'G' | 'M' | 'D'
        - `delete` 'A' | 'G' | 'M' | 'D'
        - `export` 'A' | 'G' | 'M' | 'D'
      - `companies` object — Objeto de direitos de acesso a empresas. O campo é obrigatório se o “role_id” não for passado e o sinalizador “is_free” não estiver definido.
        - `view` 'A' | 'G' | 'M' | 'D'
        - `edit` 'A' | 'G' | 'M' | 'D'
        - `add` 'A' | 'G' | 'M' | 'D'
        - `delete` 'A' | 'G' | 'M' | 'D'
        - `export` 'A' | 'G' | 'M' | 'D'
      - `tasks` object — Objeto de direitos de acesso a tarefas. O campo é obrigatório se o “role_id” não for passado e o sinalizador “is_free” não estiver definido.
        - `view` 'A' | 'G' | 'M' | 'D'
        - `edit` 'A' | 'G' | 'M' | 'D'
        - `add` 'A' | 'G' | 'M' | 'D'
        - `delete` 'A' | 'G' | 'M' | 'D'
        - `export` 'A' | 'G' | 'M' | 'D'
      - `status_rights` string, json — Um array de objetos que definem os direitos de estágio. É nulo por padrão. Se o campo rights[status_rights] com o valor “null” for passado, o usuário receberá direitos “restritos” para estágios de Leads de Entrada.
      - `mail_access` boolean — Define se a funcionalidade de E-mail é permitida para o usuário. É falso por padrão.
      - `catalog_access` boolean — Define se a funcionalidade de Listas é permitida para o usuário. É falso por padrão.
      - `is_free` boolean — Define se é um usuário gratuito. Se o valor “true” for passado no campo “is_free”, os valores dos seguintes campos serão ignorados: rights[leads], rights[tasks], rights[contacts], rights[companies], rights[status_rights], rights[mail_access], rights[catalog_access], rights[role_id], rights[group_id].
      - `role_id` integer — ID da função do usuário. É nulo por padrão. Se um valor válido de “role_id” for passado, os valores dos seguintes campos serão ignorados: rights[leads], rights[tasks], rights[contacts], rights[companies], rights[status_rights], rights[mail_access], rights[catalog_access].
      - `group_id` integer — ID do grupo do usuário. É nulo por padrão. Se o valor “null” for passado no campo rights[group_id], o usuário será adicionado ao grupo padrão “Sales Office”.
      - `request_id` string — Campo que será retornado inalterado na resposta e não será salvo.

## Response `201`

201

- object
  - `_total_items` integer
  - `_embedded` object
    - `users` object[]
      - `id` integer
      - `name` string
      - `email` string
      - `lang` string
      - `rights` object
        - `leads` object
          - `view` string
          - `edit` string
          - `add` string
          - `delete` string
          - `export` string
        - `contacts` object
          - `view` string
          - `edit` string
          - `add` string
          - `delete` string
          - `export` string
        - `companies` object
          - `view` string
          - `edit` string
          - `add` string
          - `delete` string
          - `export` string
        - `tasks` object
          - `edit` string
          - `delete` string
        - `mail_access` boolean
        - `catalog_access` boolean
        - `status_rights` object[]
          - `entity_type` string
          - `pipeline_id` integer
          - `status_id` integer
          - `rights` object
            - `view` string
            - `edit` string
            - `delete` string
        - `is_admin` boolean
        - `role_id` unknown
        - `is_free` boolean
        - `group_id` unknown
        - `is_active` boolean
      - `request_id` string
      - `_links` object
        - `self` object
          - `href` string

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403

---

[API](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo.md) · [All operations](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/referencias-de-api-da-kommo/versions/98fdf05c2f5b/schema)