---
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`

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.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/revisions/f17af4d23c7c/schema)