### View Pipeline Changes Audit Source: https://developers.hubspot.com/docs/api/crm/pipelines Make a GET request to this endpoint to retrieve a history of updates made to a specific pipeline. The response lists updates in reverse chronological order. ```json { "results": [ { "portalId": 123456, "identifier": "123456:11348541", "action": "UPDATE", "timestamp": "2024-10-07T20:58:57.414Z", "message": "Pipeline update", "rawObject": "{\"displayOrder\":1,\"pipelineId\":\"11348541\",\"portalId\":123456,\"objectType\":\"DEAL\",\"objectTypeId\":\"0-3\",\"version\":11,\"label\":\"Partner pipeline\",\"active\":true,\"stages\":[{\"displayOrder\":0,\"portalId\":123456,\"objectTypeId\":\"0-3\",\"pipelineId\":\"11348541\",\"stageId\":\"11348542\",\"label\":\"Appointment scheduled\",\"metadata\":{\"isClosed\":\"false\",\"probability\":\"0.2\"},\"maxVisibleVersion\":null,\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1614359253457,\"updatedAt\":1728334737395,\"writePermissions\":\"CRM_PERMISSIONS_ENFORCEMENT\",\"internalWriteOnly\":false,\"active\":true,\"isApprovalStage\":null},{\"displayOrder\":1,\"portalId\":123456,\"objectTypeId\":\"0-3\",\"pipelineId\":\"11348541\",\"stageId\":\"11348543\",\"label\":\"Qualified to buy\",\"metadata\":{\"isClosed\":\"false\",\"probability\":\"0.4\"},\"maxVisibleVersion\":null,\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1614359253457,\"updatedAt\":1728334737395,\"writePermissions\":\"CRM_PERMISSIONS_ENFORCEMENT\",\"internalWriteOnly\":false,\"active\":true,\"isApprovalStage\":null},{\"displayOrder\":2,\"portalId\":123456,\"objectTypeId\":\"0-3\",\"pipelineId\":\"11348541\",\"stageId\":\"11348544\",\"label\":\"Presentation scheduled\",\"metadata\":{\"isClosed\":\"false\",\"probability\":\"0.6\"},\"maxVisibleVersion\":null,\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1614359253457,\"updatedAt\":1728334737395,\"writePermissions\":\"CRM_PERMISSIONS_ENFORCEMENT\",\"internalWriteOnly\":false,\"active\":true,\"isApprovalStage\":null},{\"displayOrder\":3,\"portalId\":123456,\"objectTypeId\":\"0-3\",\"pipelineId\":\"11348541\",\"stageId\":\"11348545\",\"label\":\"Decision Maker Bought-In\",\"metadata\":{\"isClosed\":\"false\",\"probability\":\"0.8\"},\"maxVisibleVersion\":null,\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1614359253457,\"updatedAt\":1728334737395,\"writePermissions\":\"CRM_PERMISSIONS_ENFORCEMENT\",\"internalWriteOnly\":false,\"active\":true,\"isApprovalStage\":null},{\"displayOrder\":4,\"portalId\":123456,\"objectTypeId\":\"0-3\",\"pipelineId\":\"11348541\",\"stageId\":\"11348546\",\"label\":\"Contract sent\",\"metadata\":{\"isClosed\":\"false\",\"probability\":\"0.9\"},\"maxVisibleVersion\":null,\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1614359253457,\"updatedAt\":1728334737395,\"writePermissions\":\"CRM_PERMISSIONS_ENFORCEMENT\",\"internalWriteOnly\":false,\"active\":true,\"isApprovalStage\":null},{\"displayOrder\":5,\"portalId\":123456,\"objectTypeId\":\"0-3\",\"pipelineId\":\"11348541\",\"stageId\":\"259717454\",\"label\":\"Contract signed\",\"metadata\":{\"isClosed\":\"false\",\"probability\":\"0.2\"},\"maxVisibleVersion\":null,\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1728334734115,\"updatedAt\":1728334737395,\"writePermissions\":\"CRM_PERMISSIONS_ENFORCEMENT\",\"internalWriteOnly\":false,\"active\":true,\"isApprovalStage\":null},{\"displayOrder\":6,\"portalId\":123456,\"objectTypeId\":\"0-3\",\"pipelineId\":\"11348541\",\"stageId\":\"11348547\",\"label\":\"Closed won\",\"metadata\":{\"isClosed\":\"true\",\"probability\":\"1.0\"},\"maxVisibleVersion\":null,\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1614359253457,\"updatedAt\":1728334737395,\"writePermissions\":\"CRM_PERMISSIONS_ENFORCEMENT\",\"internalWriteOnly\":false,\"active\":true,\"isApprovalStage\":null},{\"displayOrder\":7,\"portalId\":123456,\"objectTypeId\":\"0-3\",\"pipelineId\":\"11348541\",\"stageId\":\"11348548\",\"label\":\"Closed lost\",\"metadata\":{\"isClosed\":\"false\",\"probability\":\"0.8\"},\"maxVisibleVersion\":null,\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1614359253457,\"updatedAt\":1728334737395,\"writePermissions\":\"CRM_PERMISSIONS_ENFORCEMENT\",\"internalWriteOnly\":false,\"active\":true,\"isApprovalStage\":null}],\"createdBy\":9586504,\"updatedBy\":9586504,\"createdAt\":1614359253457,\"updatedAt\":1728334737395,\"limitExempt\":false,\"autoCloseDateEnabled\":true,\"clearCloseDateWhenMovingClosedToOpen\":false,\"permission\":null,\"createStageId\":null,\"inactiveDefaultPipeli"} ``` -------------------------------- ### Get Pipeline Audit Log Source: https://developers.hubspot.com/docs/api/crm/pipelines Retrieve a log of changes made to a specific pipeline. Updates are listed in reverse chronological order. ```APIDOC ## GET /crm/v3/pipelines/{objectType}/{pipelineId}/audit ### Description Retrieves the audit log for a specific pipeline, detailing changes made over time. ### Method GET ### Endpoint /crm/v3/pipelines/{objectType}/{pipelineId}/audit ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline is associated with (e.g., DEAL). - **pipelineId** (string) - Required - The unique identifier of the pipeline. ### Response #### Success Response (200) - **results** (array) - A list of audit log entries. - **portalId** (integer) - The ID of the portal. - **identifier** (string) - A unique identifier for the audit entry. - **action** (string) - The type of action performed (e.g., UPDATE). - **timestamp** (string) - The date and time the action occurred in ISO 8601 format. - **message** (string) - A description of the change. - **rawObject** (object) - The raw JSON representation of the object at the time of the change. ``` -------------------------------- ### Get Stage Audit Log Source: https://developers.hubspot.com/docs/api/crm/pipelines Retrieve a log of changes made to a specific pipeline stage. Updates are listed in reverse chronological order. ```APIDOC ## GET /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId}/audit ### Description Retrieves the audit log for a specific pipeline stage, detailing changes made over time. ### Method GET ### Endpoint /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId}/audit ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline is associated with (e.g., DEAL). - **pipelineId** (string) - Required - The unique identifier of the pipeline. - **stageId** (string) - Required - The unique identifier of the stage. ### Response #### Success Response (200) - **results** (array) - A list of audit log entries. - **portalId** (integer) - The ID of the portal. - **identifier** (string) - A unique identifier for the audit entry. - **action** (string) - The type of action performed (e.g., UPDATE). - **timestamp** (string) - The date and time the action occurred in ISO 8601 format. - **message** (string) - A description of the change. - **rawObject** (object) - The raw JSON representation of the object at the time of the change. ``` -------------------------------- ### Create a new pipeline stage Source: https://developers.hubspot.com/docs/api/crm/pipelines Use this when adding a new stage to an existing pipeline. Ensure the 'probability' is between 0.0 and 1.0 for deals, or specify 'ticketState' for tickets. ```json { "metadata": { "probability": "0.8" }, "displayOrder": 4, "label": "Contract signed" } ``` -------------------------------- ### Create a pipeline Source: https://developers.hubspot.com/docs/api/crm/pipelines Create a new pipeline for a specific object type. This requires specifying the display order, label, and stages, including metadata like probability for deals or ticket state for tickets. ```APIDOC ## POST /crm/v3/pipelines/{objectType} ### Description Create a new pipeline for a given object type. ### Method POST ### Endpoint `/crm/v3/pipelines/{objectType}` ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object to create a pipeline for (e.g., deals, tickets). #### Request Body - **displayOrder** (number) - Required - The order in which the pipeline is displayed. - **label** (string) - Required - The name of the pipeline. - **stages** (array) - Required - An array of stage objects to include in the pipeline. - **label** (string) - Required - The name of the stage. - **displayOrder** (number) - Required - The order in which the stage is displayed. - **metadata** (object) - Optional - Properties related to the stage. For deals, 'probability' (0.0-1.0) is required. For tickets, 'ticketState' ('OPEN' or 'CLOSED') can be included. ### Request Example ```json { "displayOrder": 3, "label": "New deal pipeline", "stages": [ { "label": "In Progress", "metadata": { "probability": "0.2" }, "displayOrder": 0 }, { "label": "Contract signed", "metadata": { "probability": "0.8" }, "displayOrder": 1 }, { "label": "Closed Won", "metadata": { "probability": "1.0" }, "displayOrder": 2 }, { "label": "Closed Lost", "metadata": { "probability": "0.0" }, "displayOrder": 3 } ] } ``` ``` -------------------------------- ### Create a stage Source: https://developers.hubspot.com/docs/api/crm/pipelines Adds a new stage to a specified pipeline. Requires displayOrder, label, and metadata (which includes probability for deals or ticketState for tickets). ```APIDOC ## POST /crm/v3/pipelines/{objectType}/{pipelineId}/stages ### Description Creates a new stage within a specified CRM pipeline. ### Method POST ### Endpoint /crm/v3/pipelines/{objectType}/{pipelineId}/stages ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline is associated with (e.g., deals, tickets). - **pipelineId** (string) - Required - The ID of the pipeline to add the stage to. #### Request Body - **displayOrder** (number) - Required - The order of the stage in the pipeline. - **label** (string) - Required - The name of the stage. - **metadata** (object) - Optional - Additional properties for the stage. For deals, `probability` (0.0-1.0) is required. For tickets, `ticketState` ('OPEN' or 'CLOSED') can be included. ### Request Example ```json { "metadata": { "probability": "0.8" }, "displayOrder": 4, "label": "Contract signed" } ``` ### Response #### Success Response (200 or 201) - **id** (string) - The unique identifier of the created stage. - **label** (string) - The name of the stage. - **displayOrder** (number) - The display order of the stage. - **metadata** (object) - Metadata associated with the stage. - **createdAt** (string) - Timestamp of creation. - **updatedAt** (string) - Timestamp of last update. ``` -------------------------------- ### Create a New Deal Pipeline Source: https://developers.hubspot.com/docs/api/crm/pipelines Use this JSON payload to create a new deal pipeline. Ensure 'probability' is between 0.0 and 1.0 for stages. ```json { "displayOrder": 3, "label": "New deal pipeline", "stages": [ { "label": "In Progress", "metadata": { "probability": "0.2" }, "displayOrder": 0 }, { "label": "Contract signed", "metadata": { "probability": "0.8" }, "displayOrder": 1 }, { "label": "Closed Won", "metadata": { "probability": "1.0" }, "displayOrder": 2 }, { "label": "Closed Lost", "metadata": { "probability": "0.0" }, "displayOrder": 3 } ] } ``` -------------------------------- ### Create a pipeline Source: https://developers.hubspot.com/docs/api/crm/pipelines Creates a new pipeline in the CRM. ```APIDOC ## POST /pipelines ### Description Creates a new pipeline in the CRM. ### Method POST ### Endpoint /pipelines ### Request Body - **name** (string) - Required - The name of the pipeline. - **label** (string) - Required - The display label for the pipeline. - **displayOrder** (integer) - Required - The order in which to display the pipeline. ### Request Example { "name": "pipeline_name", "label": "Pipeline Label", "displayOrder": 0 } ### Response #### Success Response (200) - **id** (string) - The unique identifier for the created pipeline. - **name** (string) - The name of the pipeline. - **label** (string) - The display label for the pipeline. - **displayOrder** (integer) - The order in which to display the pipeline. #### Response Example { "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "name": "pipeline_name", "label": "Pipeline Label", "displayOrder": 0 } ``` -------------------------------- ### Retrieve stages Source: https://developers.hubspot.com/docs/api/crm/pipelines Fetches all stages within a pipeline or details of a specific individual stage. ```APIDOC ## GET /crm/v3/pipelines/{objectType}/{pipelineId}/stages ### Description Retrieves all stages within a specified pipeline. ### Method GET ### Endpoint /crm/v3/pipelines/{objectType}/{pipelineId}/stages ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline is associated with. - **pipelineId** (string) - Required - The ID of the pipeline to retrieve stages from. ### Response #### Success Response (200) - **results** (array) - An array of stage objects, each containing `id`, `label`, `displayOrder`, `createdAt`, and `updatedAt`. ``` ```APIDOC ## GET /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} ### Description Retrieves details for a specific stage within a pipeline. ### Method GET ### Endpoint /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline is associated with. - **pipelineId** (string) - Required - The ID of the pipeline containing the stage. - **stageId** (string) - Required - The ID of the stage to retrieve. ### Response #### Success Response (200) - **id** (string) - The unique identifier of the stage. - **label** (string) - The name of the stage. - **displayOrder** (number) - The display order of the stage. - **metadata** (object) - Metadata associated with the stage. - **createdAt** (string) - Timestamp of creation. - **updatedAt** (string) - Timestamp of last update. ``` -------------------------------- ### Retrieve pipelines Source: https://developers.hubspot.com/docs/api/crm/pipelines Retrieve all pipelines for a given object type or fetch details for a specific individual pipeline. ```APIDOC ## GET /crm/v3/pipelines/{objectType} ### Description Retrieve all pipelines for a given object type. ### Method GET ### Endpoint `/crm/v3/pipelines/{objectType}` ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object to retrieve pipelines for. ``` ```APIDOC ## GET /crm/v3/pipelines/{objectType}/{pipelineId} ### Description Retrieve an individual pipeline by its ID. ### Method GET ### Endpoint `/crm/v3/pipelines/{objectType}/{pipelineId}` ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline belongs to. - **pipelineId** (string) - Required - The ID of the pipeline to retrieve. ``` -------------------------------- ### Retrieve all pipelines Source: https://developers.hubspot.com/docs/api/crm/pipelines Retrieves a list of all pipelines in the CRM. ```APIDOC ## GET /pipelines ### Description Retrieves a list of all pipelines in the CRM. ### Method GET ### Endpoint /pipelines ### Response #### Success Response (200) - **results** (array) - An array of pipeline objects. - **id** (string) - The unique identifier for the pipeline. - **name** (string) - The name of the pipeline. - **label** (string) - The display label for the pipeline. - **displayOrder** (integer) - The order in which to display the pipeline. #### Response Example { "results": [ { "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "name": "pipeline_name", "label": "Pipeline Label", "displayOrder": 0 } ] } ``` -------------------------------- ### Return a pipeline by ID Source: https://developers.hubspot.com/docs/api/crm/pipelines Retrieves a specific pipeline by its unique identifier. ```APIDOC ## GET /pipelines/{pipelineId} ### Description Retrieves a specific pipeline by its unique identifier. ### Method GET ### Endpoint /pipelines/{pipelineId} ### Parameters #### Path Parameters - **pipelineId** (string) - Required - The ID of the pipeline to retrieve. ### Response #### Success Response (200) - **id** (string) - The unique identifier for the pipeline. - **name** (string) - The name of the pipeline. - **label** (string) - The display label for the pipeline. - **displayOrder** (integer) - The order in which to display the pipeline. #### Response Example { "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "name": "pipeline_name", "label": "Pipeline Label", "displayOrder": 0 } ``` -------------------------------- ### Replace a pipeline Source: https://developers.hubspot.com/docs/api/crm/pipelines Replaces an existing pipeline with new details. ```APIDOC ## PUT /pipelines/{pipelineId} ### Description Replaces an existing pipeline with new details. ### Method PUT ### Endpoint /pipelines/{pipelineId} ### Parameters #### Path Parameters - **pipelineId** (string) - Required - The ID of the pipeline to replace. ### Request Body - **name** (string) - Required - The updated name of the pipeline. - **label** (string) - Required - The updated display label for the pipeline. - **displayOrder** (integer) - Required - The updated order in which to display the pipeline. ### Request Example { "name": "updated_pipeline_name", "label": "Updated Pipeline Label", "displayOrder": 1 } ### Response #### Success Response (200) - **id** (string) - The unique identifier for the updated pipeline. - **name** (string) - The updated name of the pipeline. - **label** (string) - The updated display label for the pipeline. - **displayOrder** (integer) - The updated order in which to display the pipeline. #### Response Example { "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "name": "updated_pipeline_name", "label": "Updated Pipeline Label", "displayOrder": 1 } ``` -------------------------------- ### Replace a stage Source: https://developers.hubspot.com/docs/api/crm/pipelines Replaces an existing stage in a pipeline with new details. Overwrites all existing stage information. ```APIDOC ## PUT /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} ### Description Replaces an existing pipeline stage with new details provided in the request body. ### Method PUT ### Endpoint /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline is associated with. - **pipelineId** (string) - Required - The ID of the pipeline containing the stage. - **stageId** (string) - Required - The ID of the stage to replace. #### Request Body - **displayOrder** (number) - Required - The new order of the stage in the pipeline. - **label** (string) - Required - The new name of the stage. - **metadata** (object) - Optional - New metadata for the stage. For deals, `probability` (0.0-1.0) is required. For tickets, `ticketState` ('OPEN' or 'CLOSED') can be included. ### Response #### Success Response (200) - **id** (string) - The unique identifier of the updated stage. - **label** (string) - The name of the stage. - **displayOrder** (number) - The display order of the stage. - **metadata** (object) - Metadata associated with the stage. - **createdAt** (string) - Timestamp of creation. - **updatedAt** (string) - Timestamp of last update. ``` -------------------------------- ### Update a stage Source: https://developers.hubspot.com/docs/api/crm/pipelines Modifies the details of an existing stage, such as its label or display order. ```APIDOC ## PATCH /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} ### Description Updates the details of an existing pipeline stage. ### Method PATCH ### Endpoint /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline is associated with. - **pipelineId** (string) - Required - The ID of the pipeline containing the stage. - **stageId** (string) - Required - The ID of the stage to update. #### Request Body - **displayOrder** (number) - Optional - The new order of the stage in the pipeline. - **label** (string) - Optional - The new name of the stage. - **metadata** (object) - Optional - New metadata for the stage. For deals, `probability` (0.0-1.0) is required. For tickets, `ticketState` ('OPEN' or 'CLOSED') can be included. ### Response #### Success Response (200) - **id** (string) - The unique identifier of the updated stage. - **label** (string) - The name of the stage. - **displayOrder** (number) - The display order of the stage. - **metadata** (object) - Metadata associated with the stage. - **createdAt** (string) - Timestamp of creation. - **updatedAt** (string) - Timestamp of last update. ``` -------------------------------- ### Replace a pipeline Source: https://developers.hubspot.com/docs/api/crm/pipelines Replace an existing pipeline with new details. This operation overwrites the current pipeline's information with the provided data. ```APIDOC ## PUT /crm/v3/pipelines/{objectType}/{pipelineId} ### Description Replace an existing pipeline with new details. ### Method PUT ### Endpoint `/crm/v3/pipelines/{objectType}/{pipelineId}` ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline belongs to. - **pipelineId** (string) - Required - The ID of the pipeline to replace. #### Request Body - **displayOrder** (number) - Required - The order in which the pipeline is displayed. - **label** (string) - Required - The name of the pipeline. - **stages** (array) - Required - An array of stage objects to include in the pipeline. - **label** (string) - Required - The name of the stage. - **displayOrder** (number) - Required - The order in which the stage is displayed. - **metadata** (object) - Optional - Properties related to the stage. For deals, 'probability' (0.0-1.0) is required. For tickets, 'ticketState' ('OPEN' or 'CLOSED') can be included. ``` -------------------------------- ### Update a pipeline Source: https://developers.hubspot.com/docs/api/crm/pipelines Update the details of an existing pipeline, such as its label or display order. For stage modifications, use the dedicated stage endpoints. ```APIDOC ## PATCH /crm/v3/pipelines/{objectType}/{pipelineId} ### Description Update the details of an existing pipeline. ### Method PATCH ### Endpoint `/crm/v3/pipelines/{objectType}/{pipelineId}` ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline belongs to. - **pipelineId** (string) - Required - The ID of the pipeline to update. #### Request Body - **displayOrder** (number) - Optional - The new order for the pipeline. - **label** (string) - Optional - The new name for the pipeline. ``` -------------------------------- ### Pipeline Deletion Validation Error Source: https://developers.hubspot.com/docs/api/crm/pipelines This response indicates that a pipeline cannot be deleted because its stages are still referenced by existing records. You must move or delete these records first. ```json { "status": "error", "message": "Stage IDs: [renter_viewing, renter_security_deposit_paid, renter_new_lead, renter_closed_won, renter_closed_lost] are being referenced by object IDs: [22901690010]", "correlationId": "1fb9ac01-f574-4919-bf55-2c8c25ac1507", "context": { "stageIds": [ "[renter_viewing, renter_security_deposit_paid, renter_new_lead, renter_closed_won, renter_closed_lost]" ], "objectIds": ["[22901690010]"] }, "category": "VALIDATION_ERROR", "subCategory": "PipelineError.STAGE_ID_IN_USE" } ``` -------------------------------- ### Delete a pipeline Source: https://developers.hubspot.com/docs/api/crm/pipelines Deletes a pipeline from the CRM. ```APIDOC ## DEL /pipelines/{pipelineId} ### Description Deletes a pipeline from the CRM. ### Method DELETE ### Endpoint /pipelines/{pipelineId} ### Parameters #### Path Parameters - **pipelineId** (string) - Required - The ID of the pipeline to delete. ### Response #### Success Response (204) No content is returned on successful deletion. ``` -------------------------------- ### Delete a pipeline Source: https://developers.hubspot.com/docs/api/crm/pipelines Delete a pipeline. Optionally, validate that no records are currently using the pipeline before deletion. ```APIDOC ## DELETE /crm/v3/pipelines/{objectType}/{pipelineId} ### Description Delete a pipeline. ### Method DELETE ### Endpoint `/crm/v3/pipelines/{objectType}/{pipelineId}` ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline belongs to. - **pipelineId** (string) - Required - The ID of the pipeline to delete. #### Query Parameters - **validateReferencesBeforeDelete** (boolean) - Optional - If true, checks for existing records referencing the pipeline before deletion. ``` -------------------------------- ### Delete a stage Source: https://developers.hubspot.com/docs/api/crm/pipelines Removes a specified stage from a pipeline. ```APIDOC ## DELETE /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} ### Description Deletes a specific stage from a pipeline. ### Method DELETE ### Endpoint /crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} ### Parameters #### Path Parameters - **objectType** (string) - Required - The type of object the pipeline is associated with. - **pipelineId** (string) - Required - The ID of the pipeline containing the stage. - **stageId** (string) - Required - The ID of the stage to delete. ### Response #### Success Response (204) No content is returned upon successful deletion. ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.