---
title: "Adicionando pipelines"
method: POST
path: "/api/v4/leads/pipelines"
---

# Adicionando pipelines

`POST /api/v4/leads/pipelines`

## Request

- Base URL: `https://subdomain.kommo.com`
- URL: `https://subdomain.kommo.com/api/v4/leads/pipelines`
- Auth: OAuth 2

Este método permite adicionar múltiplos pipelines.

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string: Nome do Pipeline
    - `sort` integer: Define a ordem de exibição do pipeline na lista
    - `is_main` boolean: Define se o pipeline é principal para a conta
    - `is_unsorted_on` boolean: Define se os Leads de Entrada estão habilitados
    - `_embedded` object: Dados das etapas do pipeline. Você pode passar os nomes para as etapas do sistema 142 e 143 ao adicionar um pipeline.
      - `statuses` object[]
        - `id` integer: Dados das etapas do pipeline. Você pode passar os nomes para as etapas do sistema 142 e 143 ao adicionar um pipeline.
        - `name` string: Nome da Etapa
        - `sort` integer: Número da sequência da etapa no pipeline
        - `color` string: Cor da Etapa
        - `request_id` string: O campo que será retornado sem alterações na resposta e não será salvo
        - `descriptions` object: Descrição de status. Parâmetro opcional
          - `level` 'newbie' | 'candidate' | 'master': O nível de usuários para os quais a descrição do status é exibida.
          - `description` string: Descrição de status
    - `request_id` string: O campo que será retornado sem alterações na resposta e não será salvo

## Response `200`

200

- object
  - `_total_items` integer
  - `_links` object
    - `self` object
      - `href` string
  - `_embedded` object
    - `pipelines` object[]
      - `id` integer
      - `name` string
      - `sort` integer
      - `is_main` boolean
      - `is_unsorted_on` boolean
      - `is_archive` boolean
      - `account_id` integer
      - `request_id` string
      - `_links` object
        - `self` object
          - `href` string
      - `_embedded` object
        - `statuses` object[]
          - `id` integer
          - `name` string
          - `sort` integer
          - `is_editable` boolean
          - `pipeline_id` integer
          - `color` string
          - `type` integer
          - `account_id` integer
          - `_links` object
            - `self` object
              - …

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `422`: 422
- `429`: 429
- `500`: 500

---

[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)