---
title: "Add Stage"
method: POST
path: "/api/prospecting/stages"
tags: ["prospecting", "pipeline-stages"]
---

# Add Stage

`POST /api/prospecting/stages`

## Request

- Base URL: `https://api.every.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.every.ai/api/prospecting/stages`
- Auth: none declared
- TypeScript: <https://skmtc.dev/every/apis/every-api/docs/api/prospecting/stages/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- AddStageRequest
  - `label` string, required
  - `criteria` string, nullable
  - `after_stage_id` string, uuid, nullable
  - `expected_edit_version` integer, required

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-05** `c643301d3f3a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/every/apis/every-api/changes/api/prospecting/stages/post.md)

---

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