---
title: "POST /crm/pipelines"
method: POST
path: "/crm/pipelines"
tags: ["CRM Pipelines"]
---

# POST /crm/pipelines

`POST /crm/pipelines`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/crm/pipelines`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - API key in header `x-meetergo-api-user-id`

## Request body

- CreatePipelineDto
  - `name` string: Optional: omitting it takes the standard name in the caller's language. The default pipeline is no longer conjured behind a GET, so "make me the usual one" is a real request a client can send.
  - `isDefault` boolean
  - `stages` CreatePipelineStageDto[]
    - `name` string, required
    - `color` string, required
    - `isWon` boolean
    - `isLost` boolean
    - `winProbability` number
    - `rottingDays` number
    - `requiredCustomFields` string[]
    - `salesMilestone` 'start' | 'demo' | 'offer', nullable: What entering this stage records for the Sales Learning report. `null` clears it, which is why it is nullable rather than merely optional.

## Response `201`

- PipelineDto
  - `id` string, required
  - `name` string, required
  - `isDefault` boolean, required
  - `companyId` string, required
  - `stages` PipelineStageDto[]
    - `id` string, required
    - `name` string, required
    - `color` string, required
    - `order` number, required
    - `isWon` boolean, required
    - `isLost` boolean, required
    - `winProbability` number, required
    - `rottingDays` number
    - `requiredCustomFields` string[]
    - `salesMilestone` 'start' | 'demo' | 'offer', nullable
    - `pipelineId` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `429`: Rate limited. Back off and retry.

---

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