CRM Pipelines overview

Certain objects in HubSpot, including deals and tickets, support multiple pipelines. For example, when working with deals, a portal might have one pipeline for “New Sales”, and another pipeline for “Contract Renewals". For tickets, if you have a main support queue, and a separate queue for escalations, each of those queues would be a separate ticket pipeline.

Each stage is a member of exactly one pipeline. Each pipeline always has at least one stage, and each portal has at least one pipeline.

Every portal initially contains a default pipeline with the pipelineId “default”. On portals that have only one pipeline, the pipeline property for any object will be set to “default” automatically. On portals that have multiple pipelines, if you're setting a stage that is not in the default pipeline, you'll also need to set the pipeline property that lines up with the stage being used.

Each pipeline will have the following data.

{
  "pipelineId": "api_test_pipeline",
  // String; The internal ID of the pipeline. This ID must be used when referencing the pipeline using the API.
  "createdAt": 1531316781557,
  // Integer; A Unix timestamp in milliseconds representing when the pipeline was created.
  "updatedAt": 1532367855541,
  // Integer; A Unix timestamp in milliseconds representing when the pipeline was last updated.
  "objectType": "TICKET",
  // String, one of TICKET or DEAL; The object type that the pipeline is for.
  "label": "Updated ticket pipeline",
  // String; The label of the pipeline. The label is displayed for the pipeline in HubSpot.
  "displayOrder": 2,
  // Integer; When viewing records in HubSpot, pipelines are displayed starting with the pipeline with the lowest displayOrder value.
  "active": true,
  // Boolean; Only active pipelines can be used when updating records.
  "stages": [
  // A list of stages for the pipeline.
  // Each stage will have the following properties.
    {
      "stageId": "example_stage",
      // String; The internal id of the stage.
      "createdAt": 1531316781557,
      // Integer; A Unix timestamp in milliseconds representing when the stage was created.
      "updatedAt": 1532367855541,
      // Integer; A Unix timestamp in milliseconds representing when the stage was last updated.
      "label": "Example stage",
      // String; The label of the stage. The label is displayed when viewing records in HubSpot.
      "displayOrder": 1,
      // Integer; When viewing records in HubSpot, stages are displayed starting with the stage with the lowest displayOrder value.
      "metadata": {},
      // Reserved for future use.
      "active": true
      // Boolean; only active stages can be used when updating records
    },
    {
      "stageId": "another_example_stage",
      "createdAt": 1531316781557,
      "updatedAt": 1532367855541,
      "label": "Another example stage",
      "displayOrder": 2,
      "metadata": {},
      "active": true
    }
  ],
  "default": false
  // Boolean; Whether or not this pipeline is the default pipeline. 
}

CRM Pipelines API docs

Get all pipelines for a specified object type
Create a new pipeline
Update an existing pipeline
Delete an existing pipeline

Docs for this section or API