---
title: "Adding roles"
method: POST
path: "/api/v4/roles"
---

# Adding roles

`POST /api/v4/roles`

This method allows to add multiple roles to the account

## Headers

- `Content-Type` string

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string — Role name
    - `rights` object — User rights. By default all access is restricted.
      - `leads` object — Leads access rights object
        - `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 — Contacts access rights object
        - `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 — Companies access rights object
        - `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 — Tasks access rights object
        - `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 — An array of the objects that define stages rights. It is null by default.
      - `mail_access` boolean — Defines whether Mail functionality is allowed for the user. It is false by default.
      - `catalog_access` boolean — Defines whether Lists functionality is allowed for the user. It is false by default.
    - `request_id` string — Field that will be returned unchanged in the response and will not be saved.

## Response `201`

201

## Other responses

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

---

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