There's a new version of the HubSpot API

Check out the new API
View Beta Docs

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 January 7, 2025

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

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example GET URL: https://api.hubapi.com/automation/v3/performance/workflow/3107089?start=1527825600000&end=1530417600000&bucket=DAY Example Response: [ { "series": "ENROLLED", "bucket": "2018-06-29", "frequency": 102 }, { "series": "ENROLLED", "bucket": "2018-06-28", "frequency": 8 }, { "series": "ENROLLED", "bucket": "2018-06-27", "frequency": 518 }, { "series": "UNENROLLED", "bucket": "2018-06-29", "frequency": 1 }, { "series": "COMPLETED", "bucket": "2018-06-29", "frequency": 101 }, { "series": "COMPLETED", "bucket": "2018-06-28", "frequency": 8 }, { "series": "COMPLETED", "bucket": "2018-06-27", "frequency": 518 } ]