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 events

Last updated May 15, 2023

GET /reports/v2/events

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Required Scope:

business-intelligence

This endpoint is used to get data for all events in a HubSpot account with a Marketing Hub Enterprise subscription. Events can be created in-app or dynamically via the Tracking Code API

Use case for this endpoint: You can use this method to retrieve all event definitions and confirm data is syncing with an external analytics solution.

Response details

Returns all of the event definitions in a given portal.

Note: Access to the data from this endpoint will require a Marketing Hub Enterprise subscription. Please see the Analytics API Overview for more details.

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.

Optional parameters How to use Description
Include deleted includeDeletes=true If specified as true, include deleted events