---
title: "Añadir usuarios"
method: POST
path: "/api/v4/users"
---

# Añadir usuarios

`POST /api/v4/users`

Este método permite añadir múltiples usuarios a la cuenta.

## Headers

- `Content-Type` string

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string — Nombre completo del usuario. El valor no debe contener símbolos especiales (excepto .@-_), espacios ni enlaces. No debe superar los 50 caracteres
    - `email` string — Correo del usuario
    - `password` string — Contraseña del usuario. Debe tener al menos 6 caracteres y contener al menos 1 dígito, una letra mayúscula y una letra minúscula
    - `lang` string — Idioma del usuario. Uno de los siguientes: ru, en, es, pt. Es el idioma de la cuenta por defecto (ru, en, es o pt)
    - `rights` object — Permisos del usuario. El campo no es obligatorio, por defecto todo el acceso está restringido
      - `leads` object — Objeto de permisos de acceso a los leads. Este campo es obligatorio si no se proporciona 'role_id' y no se ha establecido el indicador 'is_free'
        - `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 permisos de acceso a los contactos. El campo es obligatorio si no se proporciona 'role_id' y no se ha establecido el indicador 'is_free'
        - `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 permisos de acceso a compañías. El campo es obligatorio si no se proporciona 'role_id' y no se ha establecido el indicador 'is_free'
        - `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 permisos de acceso a tareas. El campo es obligatorio si no se proporciona 'role_id' y no se ha establecido el indicador 'is_free'
        - `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 — Un arreglo de objetos que define los permisos de las etapas. Por defecto, es null. Si se envía el campo rights[status_rights] con el valor 'null', el usuario recibirá permisos 'restringidos' para las etapas de Leads entrantes
      - `mail_access` boolean — Define si la funcionalidad de Mail está permitida para el usuario. Por defecto, es false
      - `catalog_access` boolean — Define si la funcionalidad de Lists está permitida para el usuario. Por defecto, es false
      - `is_free` boolean — Define si es un usuario gratuito. Si se pasa el valor 'true' al campo 'is_free', los valores de los siguientes campos serán 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 del rol del usuario. Por defecto, es null. Si se pasa un valor válido para 'role_id', los valores de los siguientes campos serán ignorados: rights[leads], rights[tasks], rights[contacts], rights[companies], rights[status_rights], rights[mail_access], rights[catalog_access]
      - `group_id` integer — ID del grupo del usuario. Por defecto, es null. Si se pasa el valor 'null' al campo rights[group_id], el usuario será añadido al grupo predeterminado 'Sales Office'
      - `request_id` string — Campo que será retornado sin cambios en la respuesta y que no será guardado

## 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/kommo-api.md) · [All operations](https://skmtc.net/kommo/apis/kommo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/kommo-api/versions/e291c0b2038d/schema)