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.

Get workflows

Last updated May 15, 2023

GET /automation/v3/workflows

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

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


Get a list of workflows for a HubSpot portal. This endpoint is particularly useful if you are looking for a particular workflow and need to look it up by an Id. The endpoint only returns metadata for each workflow.

The endpoint can also be used when syncing to a CRM system to display a list of workflows a salesperson can enroll a prospect into.


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.

Example URL to GET: