There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Delete a workflow

Last updated May 31, 2023

DELETE /automation/v3/workflows/:workflowId

Note: The Workflows API currently only supports contact-based workflows.

Method Details

HTTP Methods:

DELETE

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Required Scope:

automation

Delete a workflow. Because deleting a workflow could be very disruptive to a user - you might be deleting a marketing automation workflow - a good best practice is to only delete workflows that your integration created.

Required Parameters How to use Description
OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.
Workflow ID Used in the request URL Unique identifier for a particular Workflow.
Optional Parameters How to use Description
None None No optional parameters for this method.

Example URL to DELETE: https://api.hubapi.com/automation/v3/workflows/{workflowId}

The expected response for this request is 204 No Content.