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 events

Last updated January 7, 2025

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

Example URL: https://api.hubapi.com/reports/v2/events

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 request URL: https://api.hubapi.com/reports/v2/events Example response: [ { "id": "000000142311", "name": "Neilsdja", "label": null, "status":"ACTIVE" }, { "id": "000000142312", "name": "dsasd", "label": null, "status":"ACTIVE" }, { "id": "000000142313", "name": null, "label": "neil", "status":"ACTIVE" }, { "id": "000000142314", "name": null, "label": "greate", "status":"ACTIVE" }, { "id": "000000142321", "name": null, "label": "justforfun", "status":"ACTIVE" }, { "id": "000000142322", "name": null, "label": "nothing", "status":"ACTIVE" }, { "id": "000000142435", "name": null, "label": "happiness", "status":"ACTIVE" }, { "id": "000000142589", "name": null, "label": "myCustomEvent", "status":"ACTIVE" }, { "id": "000000144050", "name": "Hello Event", "label": null, "status":"ACTIVE" } ]
import requests import json url = "https://api.hubapi.com/reports/v2/events?hapikey=demo" r= requests.get(url = url); print(r.text)
var request = require("request"); var options = { method: 'GET', url: 'https://api.hubapi.com/reports/v2/events', qs: { hapikey: 'demo' } request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); });