# Create a pipeline stage

Create a new custom pipeline stage.

Endpoint: POST /leads/api/pipeline-stages
Version: 2.0.0
Security: bearerAuth

## Request fields (application/json):

  - `name` (string, required)
    Example: "Demo Booked"

  - `object` (string, required)
    Enum: "lead", "company"

  - `category` (string, required)
    Visual category for the stage.
    Enum: "cold", "engaging", "positive", "negative"

  - `order` (integer)
    Display order.
    Example: 5

## Response 201 fields (application/json):

  - `uuid` (string)
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `team_id` (integer)

  - `name` (string)
    Example: "Demo Booked"

  - `object` (string)
    Enum: "lead", "company"

  - `type` (string)
    Enum: "custom", "new", "approaching", "engaging", "replied"

  - `category` (string)
    Enum: "cold", "engaging", "positive", "negative"

  - `order` (integer)