curl --request POST \
--url https://api.hubapi.com/crm/pipelines/2026-03/{objectType}/{pipelineId}/stages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"displayOrder": 123,
"label": "<string>",
"metadata": {},
"stageId": "<string>"
}
'{
"archived": true,
"createdAt": "2023-11-07T05:31:56Z",
"displayOrder": 123,
"id": "<string>",
"label": "<string>",
"metadata": {},
"updatedAt": "2023-11-07T05:31:56Z",
"writePermissions": "CRM_PERMISSIONS_ENFORCEMENT",
"archivedAt": "2023-11-07T05:31:56Z"
}Create a pipeline stage
curl --request POST \
--url https://api.hubapi.com/crm/pipelines/2026-03/{objectType}/{pipelineId}/stages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"displayOrder": 123,
"label": "<string>",
"metadata": {},
"stageId": "<string>"
}
'{
"archived": true,
"createdAt": "2023-11-07T05:31:56Z",
"displayOrder": 123,
"id": "<string>",
"label": "<string>",
"metadata": {},
"updatedAt": "2023-11-07T05:31:56Z",
"writePermissions": "CRM_PERMISSIONS_ENFORCEMENT",
"archivedAt": "2023-11-07T05:31:56Z"
}Documentation Index
Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Supported products
Supported products
Required Scopes
Required Scopes
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
The order for displaying this pipeline stage. If two pipeline stages have a matching displayOrder, they will be sorted alphabetically by label.
A label used to organize pipeline stages in HubSpot's UI. Each pipeline stage's label must be unique within that pipeline.
A JSON object containing properties that are not present on all object pipelines.
For deals pipelines, the probability field is required ({ "probability": 0.5 }), and represents the likelihood a deal will close. Possible values are between 0.0 and 1.0 in increments of 0.1.
For tickets pipelines, the ticketState field is optional ({ "ticketState": "OPEN" }), and represents whether the ticket remains open or has been closed by a member of your Support team. Possible values are OPEN or CLOSED.
Show child attributes
Show child attributes
Response
successful operation
Whether the pipeline is archived.
The date the pipeline stage was created. The stages on default pipelines will have createdAt = 0.
The order for displaying this pipeline stage. If two pipeline stages have a matching displayOrder, they will be sorted alphabetically by label.
A unique identifier generated by HubSpot that can be used to retrieve and update the pipeline stage.
A label used to organize pipeline stages in HubSpot's UI. Each pipeline stage's label must be unique within that pipeline.
A JSON object containing properties that are not present on all object pipelines.
For deals pipelines, the probability field is required ({ "probability": 0.5 }), and represents the likelihood a deal will close. Possible values are between 0.0 and 1.0 in increments of 0.1.
For tickets pipelines, the ticketState field is optional ({ "ticketState": "OPEN" }), and represents whether the ticket remains open or has been closed by a member of your Support team. Possible values are OPEN or CLOSED.
Show child attributes
Show child attributes
The date the pipeline stage was last updated.
Defines the level of write access for the pipeline stage, with possible values being CRM_PERMISSIONS_ENFORCEMENT, READ_ONLY, or INTERNAL_ONLY.
CRM_PERMISSIONS_ENFORCEMENT, INTERNAL_ONLY, READ_ONLY The date the pipeline was archived. archivedAt will only be present if the pipeline is archived.
Was this page helpful?