--- title: "Adicionando usuários" method: POST path: "/api/v4/users" --- # Adicionando usuários `POST /api/v4/users` ## Request - Base URL: `https://subdomain.kommo.com` - URL: `https://subdomain.kommo.com/api/v4/users` - Auth: OAuth 2 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` 'ru' | 'en' | 'es' | 'pt' | 'tr' | 'id': Idioma do usuário. Um dos seguintes: `ru`, `en`, `es`, `pt`, `tr`, `id`. Se nenhum idioma do usuário for especificado, o idioma da conta será usado por padrão - `rights` object: Direitos do usuário. O campo não é obrigatório; por padrão, todo o acesso é `Denied`. - `leads` object: Objeto de direitos de acesso a leads. O campo é obrigatório se o `role_id` não for passado. É necessário respeitar as dependências de permissões: https://pt-developers.kommo.com/reference/usu%C3%A1rios-e-fun%C3%A7%C3%B5es - `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 passad. É necessário respeitar as dependências de permissões: https://pt-developers.kommo.com/reference/usu%C3%A1rios-e-fun%C3%A7%C3%B5es - `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. É necessário respeitar as dependências de permissões: https://pt-developers.kommo.com/reference/usu%C3%A1rios-e-fun%C3%A7%C3%B5es - `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. É necessário respeitar as dependências de permissões: https://pt-developers.kommo.com/reference/usu%C3%A1rios-e-fun%C3%A7%C3%B5es - `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. É `null` por padrão. Se o campo `rights[status_rights]` com o valor `null` for passado, o usuário receberá direitos `Denied` para estágios de Leads de Entrada. - `mail_access` boolean: Define se a funcionalidade de E-mail é permitida para o usuário. É `false` por padrão. - `catalog_access` boolean: Define se a funcionalidade de Listas é permitida para o usuário. É `false` por padrão. - `role_id` integer: ID da função do usuário. É `null` 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 `group_id: 0` (Sales Office). - `request_id` string: Campo que será retornado inalterado na resposta e não será salvo. ## Response `201` Created - 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`: Bad request - `401`: Unauthorized - `403`: Forbidden ## Changes - **2026-11-03** `55101699dddb`: 1 breaking, 1 warning, 12 info - request property `RAW_BODY/items/lang` was restricted to a list of enum values - removed the request property `RAW_BODY/items/rights/is_free` - added the new `en` enum value to the request property `RAW_BODY/items/lang` - added the new `es` enum value to the request property `RAW_BODY/items/lang` - …10 more [Operation history](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/changes/api/v4/users/post.md) --- [API](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo.md) - [All operations](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/revisions/55101699dddb?raw)