---
title: "Create deal pipeline"
method: POST
path: "/admin/deal_pipelines"
tags: ["Deal pipelines"]
---

# Create deal pipeline

`POST /admin/deal_pipelines`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/admin/deal_pipelines`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

Requires the multiple-pipelines feature on the account. Marking a pipeline `default` clears the flag on the previous default.

## Request body

- object
  - `deal_pipeline` DealPipelineWritable, required: The fields a pipeline accepts on create and update. Anything else in the body is ignored.
    - `name` string
    - `pipeline_type` string, nullable
    - `default` boolean: Make this the pipeline new deals land in. Only one pipeline is default at a time.
    - `description` string, nullable

## Response `200`

Successful Response

- DealPipelineAll
  - `id` integer
  - `name` string
  - `default` boolean: Whether new deals land in this pipeline unless another is chosen
  - `pipeline_type` string, nullable
  - `description` string, nullable
  - `created_at` string
  - `updated_at` string
  - `has_deals` boolean: Whether any deal sits in this pipeline
  - `count_deals` integer
  - `won_stage` object, nullable: The pipeline's won stage (see Deal stages)
  - `lost_stage` object, nullable: The pipeline's lost stage (see Deal stages)

## Other responses

- `403`: The credentials are valid but this user may not perform the action (permissions, a read-only token, or API access switched off).
- `422`: The request was understood but a value is missing, invalid or too long.

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)