Events Events

Name: Events Events API
Brand: Events Events
Availability: InStock

✓ 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.

Quickstart

Get started with Events Events in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"get hubspot contact events"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

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

GET STARTED

Start building with Events Events API

Explore with Jentic

View OpenAPI Document

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.

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 though 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.

Complementary

Events Send Event Completions

Send custom event completions; this API reads them back

Choose this when an agent needs to record a new behavioural event rather than query existing ones.

Complementary

Events Manage Event Definitions

Define the schemas for the custom events that this API queries

Choose this when an agent needs to create or update the event-type definitions before reading occurrences.

Complementary

CRM Contacts

Resolve the contact records that events are fired against

Choose this when an agent has an event objectId and needs the underlying contact's properties.

Alternative

Mixpanel

Dedicated product-analytics event store, broader querying than HubSpot's events feed

Choose Mixpanel when the analytics use case is product-wide rather than tied to HubSpot CRM contacts.

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.