There's a new version of the HubSpot API
As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.
Note: The Deal Pipelines API is deprecated. Please use the CRM Pipelines API to manage deal pipelines.
The Deal Pipelines API allows you to programmatically access options for the 'deal stage' and 'pipeline' properties within your instance of the HubSpot CRM.
Individual pipelines will have the following format.
{
"pipelineId": "default",
// String; The internal ID of the pipeline
"stages": [
// A list of stages for this specific pipeline.
{
"stageId": "appointmentscheduled",
// String; the internal ID of the stage. The stageId should be used when setting the dealstage property of a deal record.
"label": "Appointment Scheduled",
// String; The human-readable label for the stage. The label is used when showing the stage in HubSpot.
"probability": 0.2,
// Float; The probability that the deal will close. Used for the deal forecast.
"active": true,
// Boolean; true for any stage that's currently in use.
"displayOrder": 0,
// Integer; Used to determine the order in which the stages appear when viewed in HubSpot.
// Stages are displayed in ascending order, starting with 0.
"closedWon": false
// Bloolean; true if this stage marks a deal as closed won.
},
{
"stageId": "qualifiedtobuy",
"label": "Qualified To Buy",
"probability": 0.4,
"active": true,
"displayOrder": 1,
"closedWon": false
},
{
"stageId": "presentationscheduled",
"label": "Presentation Scheduled",
"probability": 0.6,
"active": true,
"displayOrder": 2,
"closedWon": false
},
{
"stageId": "decisionmakerboughtin",
"label": "Decision Maker Bought-In",
"probability": 0.8,
"active": true,
"displayOrder": 3,
"closedWon": false
},
{
"stageId": "contractsent",
"label": "Contract Sent",
"probability": 0.9,
"active": true,
"displayOrder": 4,
"closedWon": false
},
{
"stageId": "closedwon",
"label": "Closed Won",
"probability": 1,
"active": true,
"displayOrder": 5,
"closedWon": true
},
{
"stageId": "closedlost",
"label": "Closed Lost",
"probability": 0,
"active": true,
"displayOrder": 6,
"closedWon": false
},
{
"stageId": "new_test_stage_30%",
"label": "New test stage 30%",
"probability": 0.3,
"active": true,
"displayOrder": 7,
"closedWon": false
}
],
"label": "Sales Pipeline",
// String; The human-readable label for the pipeline. The label is used when displaying the pipeline in HubSpot.
"active": true,
// Boolean; true for any pipeline currently in use.
"displayOrder": 0
// Integer; Used to determine the order in which the pipelines appear when viewed in HubSpot.
// Pipelines are displayed in ascending order, starting with 0.
}