---
title: "Add stages to pipeline"
method: POST
path: "/api/v4/leads/pipelines/{pipeline_id}/statuses"
---

# Add stages to pipeline

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

## Request

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

This method allows adding multiple stages. You can pass stage descriptions (optional).

## Path parameters

- `pipeline_id` integer, required

## Headers

- `Content-Type` string

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string, required: Stage name
    - `sort` integer, required: Sequence number of the stage in the pipeline
    - `color` string: Stage color
    - `request_id` string: The field will be returned unchanged in the response and will not be saved.
    - `descriptions` object[]
      - `level` string: Level of users the description is shown to. Those might be "newbie", "candidate" and "master".
      - `description` string: Stage description

## 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-references.md) - [All operations](https://skmtc.dev/kommo/apis/kommo-api-references/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/kommo-api-references/revisions/d3520fdb79b3?raw)