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

# Create a Pipeline

> Creates a non-default pipeline with one active, one won and one lost stage. Automatic opportunity creation is off. Requires an admin and multiple pipelines enabled.



## OpenAPI

````yaml https://api.monaco.com/openapi.json post /v1/pipelines/
openapi: 3.2.1
info:
  title: Monaco Public API
  description: Public API for Monaco
  version: 1.0.0
servers:
  - url: https://api.monaco.com
security: []
paths:
  /v1/pipelines/:
    post:
      tags:
        - Pipelines
      summary: Create a Pipeline
      description: >-
        Creates a non-default pipeline with one active, one won and one lost
        stage. Automatic opportunity creation is off. Requires an admin and
        multiple pipelines enabled.
      operationId: create_pipeline
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePipelineRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PublicItemResponse_PipelineDetailResponse_
              example:
                data:
                  id: 550e8400-e29b-41d4-a716-446655440020
                  name: Renewals
                  is_default: false
                  auto_stage_updates_enabled: true
                  auto_create_enabled: false
                  config_version: 3f2a9c1b7d4e8a60
                  stages:
                    - id: 550e8400-e29b-41d4-a716-446655440021
                      key: renewal_review
                      display_name: Renewal Review
                      description: The customer has started reviewing the renewal terms.
                      stage_group: opportunity_validation
                      color: blue
                      allow_automatic_entry: true
                      allow_automatic_exit: true
                      opportunity_count: 3
                    - id: 550e8400-e29b-41d4-a716-446655440022
                      key: closed-won
                      display_name: Renewed
                      description: The customer signed the renewal.
                      stage_group: closed
                      outcome: won
                      color: green
                      allow_automatic_entry: true
                      allow_automatic_exit: true
                      opportunity_count: 12
                meta:
                  timestamp: '2026-11-10T12:00:00Z'
        4XX:
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
components:
  schemas:
    CreatePipelineRequest:
      properties:
        name:
          type: string
          maxLength: 100
          minLength: 1
          title: Name
          description: Name of the pipeline, unique within the organization ignoring case
          examples:
            - Renewals
      additionalProperties: false
      type: object
      required:
        - name
      title: CreatePipelineRequest
    PublicItemResponse_PipelineDetailResponse_:
      properties:
        data:
          $ref: '#/components/schemas/PipelineDetailResponse'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      type: object
      required:
        - data
      title: PublicItemResponse[PipelineDetailResponse]
    PublicErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
      title: PublicErrorResponse
    PipelineDetailResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Unique identifier of the pipeline
        name:
          type: string
          title: Name
          description: Name of the pipeline
          examples:
            - New Business
        is_default:
          type: boolean
          title: Is Default
          description: >-
            Whether opportunities created without a `pipeline_id` go to this
            pipeline
        auto_stage_updates_enabled:
          type: boolean
          title: Auto Stage Updates Enabled
          description: >-
            Whether Monaco moves this pipeline's deals between stages
            automatically
        auto_create_enabled:
          type: boolean
          title: Auto Create Enabled
          description: Whether Monaco creates opportunities in this pipeline automatically
        config_version:
          type: string
          title: Config Version
          description: >-
            Version of the pipeline's stage configuration, sent back when
            updating the stages. It changes whenever the stages or automation
            change.
          examples:
            - 3f2a9c1b7d4e8a60
        stages:
          items:
            $ref: '#/components/schemas/PipelineStageDetail'
          type: array
          title: Stages
          description: The stages in pipeline order
      type: object
      required:
        - id
        - name
        - is_default
        - auto_stage_updates_enabled
        - auto_create_enabled
        - config_version
        - stages
      title: PipelineDetailResponse
    ResponseMeta:
      properties:
        timestamp:
          type: string
          format: date-time
          title: Timestamp
          description: Server timestamp of the response
      type: object
      title: ResponseMeta
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
          examples:
            - not_found
        message:
          type: string
          title: Message
          description: Human-readable error message
          examples:
            - Resource not found
        data:
          anyOf:
            - additionalProperties:
                anyOf:
                  - type: string
                  - type: integer
              type: object
            - type: 'null'
          title: Data
          description: >-
            Details for some codes: `field_too_long` carries `field`, `limit`
            and `actual`, plus `unit` (`items` or `bytes`) when the limit isn't
            in characters; `too_many_custom_fields` carries `entity_type` and
            `limit`
      type: object
      required:
        - code
        - message
      title: ErrorDetail
    PipelineStageDetail:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Unique identifier of the stage
        key:
          type: string
          title: Key
          description: Stage key, as written to an opportunity's `stage`. It never changes.
          examples:
            - negotiation
        display_name:
          type: string
          title: Display Name
          description: Display name of the stage
          examples:
            - Negotiation
        description:
          type: string
          title: Description
          description: >-
            What the stage means; Monaco's AI reads it to decide when a deal is
            in it
        stage_group:
          $ref: '#/components/schemas/StageGroup'
          description: Commercial phase of the stage; stages are ordered group by group
        outcome:
          anyOf:
            - $ref: '#/components/schemas/StageOutcome'
            - type: 'null'
          description: How a deal in this stage ended; set only on `closed` stages
        color:
          $ref: '#/components/schemas/DisplayColorEnum'
          description: Display color of the stage
        allow_automatic_entry:
          type: boolean
          title: Allow Automatic Entry
          description: Whether automatic stage updates may move deals into this stage
        allow_automatic_exit:
          type: boolean
          title: Allow Automatic Exit
          description: Whether automatic stage updates may move deals out of this stage
        opportunity_count:
          type: integer
          title: Opportunity Count
          description: Number of opportunities in this stage
      type: object
      required:
        - id
        - key
        - display_name
        - description
        - stage_group
        - outcome
        - color
        - allow_automatic_entry
        - allow_automatic_exit
        - opportunity_count
      title: PipelineStageDetail
    StageGroup:
      type: string
      enum:
        - pre_pipeline
        - opportunity_validation
        - solution_fit
        - commercial_commitment
        - closed
      title: StageGroup
      description: >-
        System-owned, fixed, ordered taxonomy of commercial questions.


        Customers define stages within groups; the taxonomy itself never varies
        by org or

        sales motion. Member order is the pipeline order.
    StageOutcome:
      type: string
      enum:
        - won
        - lost
        - disqualified
      title: StageOutcome
      description: How a closed opportunity ended; set exactly on closed-group stages.
    DisplayColorEnum:
      type: string
      enum:
        - green
        - blue
        - red
        - yellow
        - purple
        - berry
        - peach
        - gray
      title: DisplayColorEnum

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.