Skip to main content
PUT
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
Replace a pipeline
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "My replaced pipeline",
  "displayOrder": 0,
  "stages": [
    {
      "label": "In Progress",
      "displayOrder": 0,
      "metadata": {
        "ticketState": "OPEN"
      }
    },
    {
      "label": "Done",
      "displayOrder": 1,
      "metadata": {
        "ticketState": "CLOSED"
      }
    }
  ]
}
'
{
  "label": "My ticket pipeline",
  "displayOrder": 0,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "updatedAt": "2019-12-07T16:50:06.678Z",
  "archived": false,
  "id": "812723471",
  "stages": [
    {
      "label": "In Progress",
      "displayOrder": 0,
      "metadata": {
        "ticketState": "OPEN"
      },
      "createdAt": "2019-10-30T03:30:17.883Z",
      "updatedAt": "2019-12-07T16:50:06.678Z",
      "archived": false,
      "id": "1234912"
    },
    {
      "label": "Done",
      "displayOrder": 0,
      "metadata": {
        "ticketState": "CLOSED"
      },
      "createdAt": "2019-10-30T03:30:17.883Z",
      "updatedAt": "2019-12-07T16:50:06.678Z",
      "archived": false,
      "id": "1234914"
    }
  ]
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

objectType
string
required

The object type of the pipeline being replaced (ex. deals or tickets)

pipelineId
string
required

The unique identifier of the pipeline to be replaced.

Query Parameters

validateDealStageUsagesBeforeDelete
boolean
default:false

Indicates whether to validate deal stage usages before deleting the pipeline.

validateReferencesBeforeDelete
boolean
default:false

Indicates whether to validate references before deleting the pipeline.

Body

application/json

An input used to create or replace a pipeline's definition.

displayOrder
integer<int32>
required

The order for displaying this pipeline. If two pipelines have a matching displayOrder, they will be sorted alphabetically by label.

label
string
required

A unique label used to organize pipelines in HubSpot's UI

stages
object[]
required

Pipeline stage inputs used to create the new or replacement pipeline.

Response

successful operation

A pipeline definition.

archived
boolean
required

Whether the pipeline is archived.

createdAt
string<date-time>
required

The date the pipeline was created. The default pipelines will have createdAt = 0.

displayOrder
integer<int32>
required

The order for displaying this pipeline. If two pipelines have a matching displayOrder, they will be sorted alphabetically by label.

id
string
required

A unique identifier generated by HubSpot that can be used to retrieve and update the pipeline.

label
string
required

A unique label used to organize pipelines in HubSpot's UI

stages
object[]
required

The stages associated with the pipeline. They can be retrieved and updated via the pipeline stages endpoints.

updatedAt
string<date-time>
required

The date the pipeline was last updated.

archivedAt
string<date-time>

The date the pipeline was archived. archivedAt will only be present if the pipeline is archived.

Last modified on December 16, 2025