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:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


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:{workflowId}

The expected response for this request is 204 No Content.