---
title: "Añadir etapas al pipeline"
method: POST
path: "/api/v4/leads/pipelines/{pipeline_id}/statuses"
---

# Añadir etapas al pipeline

`POST /api/v4/leads/pipelines/{pipeline_id}/statuses`

## Request

- Base URL: `https://subdominio.kommo.com`
- URL: `https://subdominio.kommo.com/api/v4/leads/pipelines/{pipeline_id}/statuses`
- Auth: OAuth 2

Este método permite añadir múltiples etapas. Puedes pasar descripciones de las etapas (opcional).

## Path parameters

- `pipeline_id` string, required

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string, required: Nombre de la etapa
    - `sort` integer, required: Número de secuencia de la etapa en el pipeline
    - `color` string: Color de la etapa
    - `request_id` string: El campo será retornado sin cambios en la respuesta y no se guardará.
    - `descriptions` object[]
      - `level` 'newbie' | 'candidate' | 'master': El nivel de usuarios para el cual se muestra la descripción del estado
      - `description` string: Descripción del estado

## Response `200`

200

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

## Other responses

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

---

[API](https://skmtc.dev/kommo/apis/kommo-api.md) - [All operations](https://skmtc.dev/kommo/apis/kommo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/kommo-api/revisions/6e4469210c4f?raw)