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 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:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Required Scope:

automation

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