HubSpot Marketing Events Extension
Browse all Hubapi APIs★ Only Publicly Available OpenAPI DocumentMarketingMarketing Automationoauth2, apiKey16 EndpointsREST
For Agents
Register external marketing events and per-attendee state transitions in HubSpot so contact attendance is recorded against the CRM contact.
Use for: I need to register a new webinar as a HubSpot marketing event, Record that a contact attended a marketing event, Mark an event as cancelled in HubSpot, Search for marketing events by name
Not supported: Does not handle email sends, marketing campaign creation, or contact list management — use for marketing event registration and attendance state only.
Jentic publishes the only available OpenAPI specification for the HubSpot Marketing Events Extension, keeping it validated and agent-ready. The Marketing Events Extension API registers external marketing events — webinars, conferences, virtual sessions — inside HubSpot so contact attendance and registration are visible alongside other CRM activity. Apps create or upsert events by externalEventId, search and cancel events, and record per-attendee state transitions like REGISTERED, ATTENDED, or CANCELLED. It bridges third-party event platforms (Zoom, On24, Eventbrite) with HubSpot's marketing record.
Install Jentic One Beta
Connect the Marketing Events Extension to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Marketing Events Extension, 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 Marketing Events Extension API.
Register a new marketing event by externalEventId
Upsert a batch of events to keep HubSpot in sync with an external event platform
Record per-attendee state transitions (REGISTERED, ATTENDED, CANCELLED, NO_SHOW)
Cancel or complete an event and propagate the change to attendee records
Search marketing events by name, organiser, or time window
Configure app-level settings for the marketing events integration
Update attendee state by email when the contact is not yet known to HubSpot
Use Cases
Patterns agents use Marketing Events Extension API for, with concrete tasks.
★ Webinar Platform Sync
Companies running webinars on Zoom, On24, or GoToWebinar push every event and attendance update into HubSpot via this API. The events upsert endpoint keeps HubSpot in sync with the event platform, and the per-state attendance endpoints record who registered and who actually showed up. Marketing then segments and follows up based on attendance state.
Upsert event with externalEventId 'zoom-12345', name 'Q3 Product Launch Webinar', startDateTime '2026-09-15T17:00:00Z', then mark contactId 99887 as ATTENDED
Per-Attendee State Transitions
Every attendee moves through registration, attendance, and follow-up states. The /attendance/{externalEventId}/{subscriberState}/create endpoint records a new attendee in a given state, and the email-create variant accepts an email address for contacts that may not yet exist in HubSpot. The upsert variants handle the case where the attendee record might already be present.
Call POST /marketing/v3/marketing-events/attendance/zoom-12345/ATTENDED/email-create with email 'jane@example.com' and joinedAt timestamp
Event Lifecycle Management
When events get postponed or cancelled, every contact who registered needs the attendance record updated and HubSpot's view of the event marked accordingly. The cancel and complete endpoints transition the event itself, and the search endpoint helps the integration find existing events by name when an externalEventId is not known. Delete handles archival of events that should no longer appear in reports.
Call POST /marketing/v3/marketing-events/events/zoom-12345/cancel to mark the event cancelled and trigger downstream attendee updates
Agent-Driven Event Registration
An AI agent that runs the company's webinar operations uses Jentic to register attendees as they sign up on a third-party platform. It searches for 'register hubspot marketing event attendee', loads the schema, and posts the attendee state transition immediately so HubSpot's segmentation always reflects the current attendee list.
Search Jentic for 'mark hubspot event attendee', load the schema, and post the REGISTERED state transition for each new sign-up
Key Endpoints
16 endpoints — jentic publishes the only available openapi specification for the hubspot marketing events extension, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/marketing/v3/marketing-events/events/upsert
Upsert a batch of marketing events
POST
/marketing/v3/marketing-events/events/search
Search marketing events
POST
/marketing/v3/marketing-events/events/{externalEventId}/cancel
Cancel an event
POST
/marketing/v3/marketing-events/events/{externalEventId}/complete
Mark an event complete
POST
/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/create
Record an attendee state transition by contactId
POST
/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create
Record an attendee state transition by email
GET
/marketing/v3/marketing-events/{appId}/settings
Get app-level marketing events settings
POST
/marketing/v3/marketing-events/events/upsert
Upsert a batch of marketing events
POST
/marketing/v3/marketing-events/events/search
Search marketing events
POST
/marketing/v3/marketing-events/events/{externalEventId}/cancel
Cancel an event
POST
/marketing/v3/marketing-events/events/{externalEventId}/complete
Mark an event complete
POST
/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/create
Record an attendee state transition by contactId
POST
/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create
Record an attendee state transition by email
GET
/marketing/v3/marketing-events/{appId}/settings
Get app-level marketing events settings
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
HubSpot developer hapikeys, OAuth tokens, and private app tokens are stored encrypted in the Jentic vault. Agents receive a scoped token at call time so HubSpot credentials never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'create hubspot marketing event') and Jentic returns POST /marketing/v3/marketing-events/events/upsert with its input schema, including externalEventId, name, and time fields.
Time to first call
Direct HubSpot integration: 2-3 days for OAuth, event schema, attendee state mapping, and reconciliation. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Marketing Events Extension API through Jentic.
Why is there no official OpenAPI spec for the HubSpot Marketing Events Extension?
HubSpot does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the HubSpot Marketing Events Extension via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the HubSpot Marketing Events Extension API use?
It accepts the developer hapikey query parameter, OAuth 2.0 access tokens, the private-app-legacy header, and the hapikey query parameter as a legacy fallback. Jentic stores all of these in its encrypted vault and provides agents with scoped tokens at execution time.
Can I record attendance for a contact that does not yet exist in HubSpot?
Yes. Use POST /marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create with the contact's email address. HubSpot creates or updates the contact record to match and records the attendance state in the same call.
What are the rate limits for the HubSpot Marketing Events Extension API?
Standard HubSpot API limits apply: 100 requests per 10 seconds per private app token and 110 per 10 seconds per OAuth app per portal. For high-volume webinar imports, use the events upsert batch endpoint and the email-upsert attendance variants instead of one call per attendee.
How do I register a marketing event through Jentic?
Search Jentic for 'create hubspot marketing event', load the schema for POST /marketing/v3/marketing-events/events/upsert, and execute with an array of events keyed by externalEventId. For one event at a time, POST /marketing/v3/marketing-events/events with the event payload.
Is the Marketing Events Extension API free?
API access is included with any HubSpot subscription that has Marketing Hub features. Marketing event records appear on contact timelines and in Marketing Hub reports; the depth of reporting depends on the Marketing Hub subscription tier.
GET STARTED