---
title: "Add a pipeline stage"
method: POST
path: "/api/v1/reply-statuses"
tags: ["Inbox"]
---

# Add a pipeline stage

`POST /api/v1/reply-statuses`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/reply-statuses`
- Auth: HTTP bearer

Adds a stage of your own, such as Proposal sent or Demo scheduled. The key is made from the label.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Writes | `argorant:manage_lists` |

## Headers

- `Idempotency-Key` string
- `X-Request-Id` string

## Request body

- object
  - `label` string, required: Up to 40 characters.
  - `color` 'lime' | 'blue' | 'rose' | 'neutral' | 'purple' | 'yellow': Color (default blue).
  - `description` string: What the stage means, up to 300 characters.

## Response `200`

OK

- object
  - `status` object
    - `key` string
    - `label` string
    - `color` string
    - `builtin` boolean
    - `visible` boolean
    - `description` string

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:manage_lists.
- `409`: 409 Conflict. `conflict` when the label matches a built-in status; `idempotency_conflict` when the Idempotency-Key was used with another body.
- `422`: 422 Validation error. `validation_error` when a field has the wrong type or is missing.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

[API](https://skmtc.dev/argorant/apis/argorant-api.md) · [All operations](https://skmtc.dev/argorant/apis/argorant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/argorant/apis/argorant-api/revisions/4bc28c0085b6?raw)