The HubSpot Events API lets you retrieve a list of CRM object events, supporting filters by time range, object type or specific object ID, and event type, with pagination (after/before/limit) and sortable results (by occurrence time).
occurredAfter(query) — The starting time as an ISO 8601 timestamp.
occurredBefore(query) — The ending time as an ISO 8601 timestamp.
objectType(query) — The type of object being selected. Valid values are hubspot named object types (e.g. `contact`).
objectId(query) — The id of the selected object. If not present, then the `objectProperty` parameter is required.
eventType(query) — Limits the response to the specified event type. For example `&eventType=e_visited_page` returns only `e_visited_page` events. If not present all event types are returned.
after(query) — An additional parameter that may be used to get the next `limit` set of results.
before(query)
limit(query, limit) — The maximum number of events to return, defaults to 20.
sort(query) — Selects the sort field and order. Defaults to ascending, prefix with `-` for descending order. `occurredAt` is the only field supported for sorting.
1 endpoint auto-detected
Authentication
This API uses an API key, passed as the "hapikey" query parameter. No OAuth required.
curl -X GET \
"https://api.hubapi.com/events/v3/events?hapikey=YOUR_API_KEY"
