> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getoutbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Pipeline Stage

> Insert a new stage into a pipeline at the supplied position. Existing stages at or after that position shift down by one. Defaults to appending at the end.



## OpenAPI

````yaml POST /crm/pipelines/{pipeline_id}/stages/
openapi: 3.1.0
info:
  title: Outbox AI API
  description: API for managing AI agents (chatbots and voicebots) on the Outbox platform
  version: 1.0.0
servers:
  - url: https://api.getoutbox.ai
security: []
paths:
  /crm/pipelines/{pipeline_id}/stages/:
    post:
      tags:
        - crm
      summary: Create Pipeline Stage
      description: >-
        Insert a new stage into a pipeline at the supplied position. Existing
        stages at or after that position shift down by one. Defaults to
        appending at the end.
      operationId: crm_pipelines_stages_create
      parameters:
        - in: path
          name: pipeline_id
          schema:
            type: string
            format: uuid
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PipelineStageCreateRequestRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PipelineStageCreateRequestRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PipelineStageCreateRequestRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: Stage created.
        '400':
          description: >-
            Missing name, name conflict, invalid `stage_order`, or both closed
            flags set.
        '404':
          description: Pipeline not found.
      security:
        - jwtAuth: []
        - {}
components:
  schemas:
    PipelineStageCreateRequestRequest:
      type: object
      properties:
        name:
          type: string
          minLength: 1
        stage_order:
          type: integer
          description: Zero-indexed insert position. Defaults to the end of the pipeline.
        is_closed_won:
          type: boolean
          default: false
        is_closed_lost:
          type: boolean
          default: false
      required:
        - name
  securitySchemes:
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````