Skip to main content
POST
/
api
/
pipelines
/
set-default
Set a pipeline as default
curl --request POST \
  --url https://your-instance.example.com/api/pipelines/set-default \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pipelineId": "66f0a0b0c0d0e0f0a0b0c0d0"
}
'
{
  "message": "Pipeline updated",
  "pipeline": {
    "_id": "66f0a0b0c0d0e0f0a0b0c0d0",
    "name": "Sales pipeline",
    "type": "Contact",
    "isDefault": true
  },
  "contactsMigrated": {
    "New Lead -> New": 14,
    "Qualified Lead -> Qualified": 8
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
pipelineId
string
required

Pipeline to promote to default for its type; previously-default pipelines on the same type lose the flag.

Response

Default pipeline updated

​
message
string
​
pipeline
object
Example:
{
  "_id": "66f0a0b0c0d0e0f0a0b0c0d0",
  "name": "Sales pipeline",
  "description": "NA sales pipeline",
  "organizationId": "65a0e0e0e0e0e0e0e0e0e0e0",
  "type": "Contact",
  "isDefault": true,
  "isActive": true,
  "stages": [
    { "name": "New", "color": "#3B82F6" },
    { "name": "Qualified", "color": "#10B981" }
  ],
  "pipelineStageIds": [
    "67f0a0b0c0d0e0f0a0b0c0d0",
    "67f0a0b0c0d0e0f0a0b0c0d1"
  ],
  "pipelineStages": [
    {
      "_id": "67f0a0b0c0d0e0f0a0b0c0d0",
      "name": "New",
      "color": "#3B82F6",
      "position": 0
    },
    {
      "_id": "67f0a0b0c0d0e0f0a0b0c0d1",
      "name": "Qualified",
      "color": "#10B981",
      "position": 1
    }
  ],
  "createdBy": "65b1f0a2c3d4e5f6a7b8c9d0",
  "updatedBy": "65b1f0a2c3d4e5f6a7b8c9d0"
}
​
contactsMigrated
object