There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

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.