There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.

Log events

Last updated June 17, 2020

PUT  /automation/v3/logevents/workflows/:workflowId/filter

Note: This endpoint is deprecated. See this post for more details

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?






Get a history of events for a specific workflow, filtered for a specific contact and/or event type(s).

This endpoint is particularly useful for integrations that pull data on a contact and display them in an application, like a CRM or Support Desk integration.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
Workflow ID Used in the request URL The ID of the workflow you wish to see metadata for.
Filter JSON Used in the request body This JSON represents the desired Contact VID, and/or the list of event types. You can include multiple filter types, but you must include at least one filter type. See the examples for more details.
Optional Parameters How to use Description
Offset &offset=X - UTC millis The date in which the resultset cursor should start from, time descending. Defaults to current time.
Limit Date &limitDate=X - UTC millis The earliest date of an event that will be return from the resultset. Defaults to 180 days in the past from current time.