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.

Get performance statistics for a workflow

Last updated May 31, 2023

GET /automation/v3/performance/workflow/:workflowId

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

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


Get a breakdown of the performance of a workflow based on the specified time period.

The response will include the number of contacts enrolled, the number of contacts unenrolled, and the number of contacts that completed the workflow for each period as specified in the bucket parameter.

Note: The response may not include an entry for each time period as there must be at least 1 contact in the specific bucket for it to be included. For example, in the example response to the right, no contacts were unenrolled on 2018-06-27 or 2018-06-28, so there is no entry for the "UNENROLLED" series for those dates.

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.
Start date start=
Used in the request URL
The start date for the data you want. Must be specified as a millisecond timestamp.
End date end=
Used in the request URL
The end date for the data you want. Must be specified as a millisecond timestamp.
Time period bucket=
Used in the request URL
The time period used to group the data. Must be one of DAY, WEEK, or MONTH