HubSpot Events Events
Browse all Hubspot APIs✓ Official Vendor SpecAnalyticsProduct Analyticsoauth22 EndpointsREST
For Agents
Read behavioural events fired against HubSpot contacts and discover which event types exist in the portal so an agent can reconstruct customer activity timelines.
Use for: I need to fetch the event timeline for a HubSpot contact, List all event types defined in this HubSpot portal, Retrieve every page-view event for contact 12345 in the last 30 days, Find all form-submission events fired in the last week
Not supported: Does not create, update, or delete events, define event schemas, or query CRM object properties — use for reading behavioural event streams and event-type metadata only.
The HubSpot Events API exposes behavioural event streams captured against contacts in a HubSpot account, returning the chronological list of events with type, occurrence time, and contact context. It supports filtering by event type, object id, and time window so analytics agents can reconstruct customer journeys without scraping the CRM UI. The companion event-types endpoint enumerates which event names are available in the portal, including standard events (page views, form submissions, email opens) and custom behavioural events defined by the account.
Install Jentic One Beta
Connect the Events Events to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Events Events, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Events Events API.
Pull a contact's behavioural event timeline filtered by event type and date range
Enumerate the event types available in a HubSpot portal, including custom behavioural events
Page through high-volume event streams using the after cursor to feed analytics pipelines
Correlate marketing email opens, page views, and form submissions against a single contact id
Backfill product-analytics warehouses with HubSpot event history without touching the CRM UI
Use Cases
Patterns agents use Events Events API for, with concrete tasks.
★ Customer Journey Reconstruction
Pull the full chronological event stream for a HubSpot contact to reconstruct the journey from first page view through form submission, email engagement, and custom in-product events. The Events API returns each event with its occurrence timestamp, event type, and properties, so analytics tools and agents can build per-contact session timelines without polling the CRM record. Useful for support triage, churn analysis, and lead-qualification workflows.
Call GET /events/v3/events/ with objectId=12345 and occurredAfter=2026-05-01 then group the returned events by eventType and emit a timeline.
Event Type Discovery for Reporting
Before running a report, enumerate the event types defined in a HubSpot account using the event-types endpoint to discover which standard and custom behavioural events are available. The response lists each event name with metadata so an agent can validate that a requested event (for example a custom checkout_completed event) actually exists before querying for occurrences. Avoids 400-style errors from typos and surfaces newly added events automatically.
Call GET /events/v3/events/event-types and return the array of eventType names available in the portal.
Email Engagement Verification
After a marketing email send, query the Events API to verify which contacts triggered open or click events within a given window. Filtering by eventType and occurredAfter lets an agent confirm engagement against a known campaign send time, returning per-contact occurrence records. Useful for closing the loop on outbound campaigns and triggering downstream nurture flows.
Call GET /events/v3/events/ with eventType=e_visited_page or the relevant email event name, objectId=12345, and occurredAfter set to the campaign send timestamp, then assert the array is non-empty.
AI Agent Activity Lookup via Jentic
An AI agent embedded in a support tool answers "what has this customer been doing this week?" by searching Jentic for HubSpot event lookup operations, loading the input schema, and executing the call with the contact id and time window. Jentic stores the HubSpot OAuth token in MAXsystem, so the agent never touches raw credentials, and the search-load-execute flow takes seconds instead of hours of integration work.
Search Jentic for "get hubspot contact events", load the operation schema for GET /events/v3/events/, and execute with objectId=12345 and occurredAfter=now-7d.
Key Endpoints
2 endpoints — the hubspot events api exposes behavioural event streams captured against contacts in a hubspot account, returning the chronological list of events with type, occurrence time, and contact context.
METHOD
PATH
DESCRIPTION
GET
/events/v3/events/
List behavioural events filtered by contact id, event type, and time window
GET
/events/v3/events/event-types
List the event types available in the portal
GET
/events/v3/events/
List behavioural events filtered by contact id, event type, and time window
GET
/events/v3/events/event-types
List the event types available in the portal
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
HubSpot OAuth and private app tokens are stored encrypted in the Jentic MAXsystem vault. Agents receive scoped execution access — the raw bearer token never enters the agent's context window or logs.
Intent-based discovery
Agents search Jentic with intents like 'get hubspot contact events' and Jentic returns the matching operation with its input schema, so the agent calls GET /events/v3/events/ with the right parameters without browsing HubSpot docs.
Time to first call
Direct HubSpot integration: 1-2 days for OAuth setup, pagination handling, and rate-limit retries. Through Jentic: under 30 minutes — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Events Events API through Jentic.
What authentication does the Events Events API use?
The API accepts HubSpot OAuth 2.0 access tokens or private app tokens, sent as a Bearer token in the Authorization header. Through Jentic, the token is stored encrypted in the MAXsystem vault and injected at execution time, so the agent never sees the raw secret.
Can I list all behavioural events for a single contact with this API?
Yes. Call GET /events/v3/events/ with the objectId query parameter set to the contact id and optional occurredAfter, occurredBefore, and eventType filters. The response paginates with a standard after cursor.
How do I find the custom event names defined in my HubSpot portal?
Call GET /events/v3/events/event-types — the response lists every standard and custom behavioural event name available. Use the returned names as the eventType filter on the events listing endpoint.
What are the rate limits for the Events Events API?
HubSpot enforces account-level limits of 100 requests per 10 seconds for OAuth and private app tokens on most endpoints, with daily caps that depend on the subscription tier. Check the HubSpot developer portal for the exact tier limits and use the X-HubSpot-RateLimit headers returned with each response.
How do I fetch a contact's recent events through Jentic?
Run pip install jentic, search for "get hubspot contact events", load the schema for GET /events/v3/events/, and execute with objectId and occurredAfter. Sign up at https://app.jentic.com/sign-up to get an ak_* key.
Does this API write or modify events?
No. This is a read-only API for querying existing behavioural events and event-type metadata. To send custom event completions use the Events Send Event Completions API, and to define new event schemas use the Events Manage Event Definitions API.
GET STARTED