For Agents
Push marketing event records and per-attendee state changes from external event platforms into HubSpot so attendance becomes CRM data with breakdown reporting.
Get started with Marketing Marketing 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:
"upsert hubspot marketing event"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Marketing Marketing Events API.
Upsert a marketing event record from an external platform using externalEventId
Record per-attendee subscriber-state changes (registered, attended, cancelled) by event id and state
Create attendance records identified by email when the contact has no existing HubSpot id
Pull a participation breakdown for an event to see attendee state distribution
GET STARTED
Use for: I need to upsert a marketing event from our webinar platform into HubSpot, Record that contact@example.com attended event abc-123, Mark a list of contacts as registered for an upcoming webinar, Pull the attendance breakdown for an event by id
Not supported: Does not host events, send confirmation emails, or process ticketing — use for syncing external marketing event records and attendance state into HubSpot only.
The HubSpot Marketing Events API integrates external event platforms (webinars, conferences, in-person events) with HubSpot so contact attendance and registration become first-class CRM data. It manages marketing event records by externalEventId and externalAccountId, upserts attendance and participation states (registered, attended, cancelled), and exposes participation breakdowns for reporting. With 36 endpoints across event upsert, attendance create, email-create, and participation breakdown paths, it gives event-marketing tools a structured way to push their data into HubSpot timelines and workflows.
Bulk-upsert events in one call when syncing an external event platform overnight
Cross-reference participation by externalAccountId and externalEventId for multi-tenant integrations
Patterns agents use Marketing Marketing Events API for, with concrete tasks.
★ Webinar Platform to HubSpot Sync
Push webinar registrations and attendance from Zoom, ON24, or a custom platform into HubSpot so marketing-ops sees the same attendance data CRM workflows act on. POST /marketing/v3/marketing-events/events/{externalEventId} upserts the event record, and the attendance subresources record per-attendee state by email or contact id. The result: webinar engagement appears on the contact timeline and triggers HubSpot workflows.
Call POST /marketing/v3/marketing-events/events/{externalEventId} to upsert the event, then POST /marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create with attendee emails.
In-Person Event Attendance Backfill
After an in-person conference or trade show, backfill attendance into HubSpot in batches so sales follow-up sequences enrol the right contacts. The email-create attendance endpoint accepts a contact list keyed by email, removing the need to resolve HubSpot contact ids client-side. Useful for post-event marketing and demand generation.
Call POST /marketing/v3/marketing-events/attendance/{externalEventId}/attended/email-create with an array of attendee emails.
Participation Breakdown Reporting
Pull a participation breakdown for an event to see how many contacts are registered, attended, and cancelled, broken down by external account where relevant. GET /marketing/v3/marketing-events/participations/{marketingEventId}/breakdown returns the counts an agent can render directly to a dashboard, without aggregating per-attendee records client-side.
Call GET /marketing/v3/marketing-events/participations/{marketingEventId}/breakdown to read the per-state counts for the event.
AI Agent Post-Event Workflow via Jentic
An AI agent automates post-event follow-up by syncing attendance from the webinar platform, then enrolling attendees in a HubSpot workflow. The agent searches Jentic for marketing-event upsert and attendance operations, loads schemas, and runs them in sequence. Jentic stores the OAuth token, so the agent handles no raw credentials and the post-event run takes minutes.
Search Jentic for "upsert hubspot marketing event", load the schema for POST /marketing/v3/marketing-events/events/upsert, and execute with the event payload.
36 endpoints — the hubspot marketing events api integrates external event platforms (webinars, conferences, in-person events) with hubspot so contact attendance and registration become first-class crm data.
METHOD
PATH
DESCRIPTION
/marketing/v3/marketing-events/events/{externalEventId}
Upsert a marketing event by external id
/marketing/v3/marketing-events/events/upsert
Bulk upsert marketing events
/marketing/v3/marketing-events/events/{externalEventId}/{subscriberState}/upsert
Upsert attendance for an event by subscriber state
/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/create
Create attendance records by subscriber state
/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create
Create attendance records identified by email
/marketing/v3/marketing-events/participations/{marketingEventId}/breakdown
Get participation breakdown for an event
/marketing/v3/marketing-events/participations/{externalAccountId}/{externalEventId}/breakdown
Get breakdown by external account and event
/marketing/v3/marketing-events/{objectId}
Retrieve a marketing event by HubSpot object id
/marketing/v3/marketing-events/events/{externalEventId}
Upsert a marketing event by external id
/marketing/v3/marketing-events/events/upsert
Bulk upsert marketing events
/marketing/v3/marketing-events/events/{externalEventId}/{subscriberState}/upsert
Upsert attendance for an event by subscriber state
/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/create
Create attendance records by subscriber state
/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create
Create attendance records identified by email
Three things that make agents converge on Jentic-routed access.
Credential isolation
HubSpot OAuth, private app tokens, and developer API keys are stored encrypted in the Jentic MAXsystem vault. Agents receive scoped execution access — raw credentials never enter the agent's context.
Intent-based discovery
Agents search Jentic with intents like 'upsert hubspot marketing event' and Jentic returns the matching operation with its input schema, so the agent calls POST /marketing/v3/marketing-events/events/upsert with the right payload without browsing HubSpot docs.
Time to first call
Direct HubSpot integration: 3-5 days for OAuth setup, external-id mapping, attendance sync, and breakdown reporting. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
CRM Contacts
The contact records that attendance state changes attach to
Choose this when the agent needs to create or read the underlying contact for an attendee.
Marketing Single-send
Send post-event follow-up emails to attendees
Choose this once attendance is recorded and the agent needs to fire a follow-up send.
Marketing Campaigns
Attach marketing events to campaigns for attribution roll-up
Choose this when the event is one asset in a broader campaign.
Cvent
Standalone event-management platform with native registration and ticketing
Choose Cvent when the use case is end-to-end event management rather than syncing data into HubSpot.
Specific to using Marketing Marketing Events API through Jentic.
What authentication does the Marketing Events API use?
It accepts HubSpot OAuth 2.0 access tokens, private app tokens, or developer API keys (developer_hapikey for some operations), sent as Bearer or as a query parameter respectively. Through Jentic, the token is stored encrypted in MAXsystem.
Can I record attendance using only the contact's email?
Yes. POST /marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create accepts an array of attendee emails so you do not need to resolve HubSpot contact ids before sending attendance updates.
How do I sync many events from an external platform in one call?
Use POST /marketing/v3/marketing-events/events/upsert with an inputs array. Each entry carries the externalEventId, externalAccountId, and event metadata; HubSpot upserts based on the external identifiers.
What are the rate limits for the Marketing Events API?
Account-level limits are 100 requests per 10 seconds across HubSpot's authenticated APIs, with daily caps that depend on the subscription tier. Use the bulk upsert endpoints to fit more events inside the per-second window.
How do I push a webinar attendance list through Jentic?
Run pip install jentic, search for "create hubspot event attendance by email", load the schema for POST /marketing/v3/marketing-events/attendance/{externalEventId}/attended/email-create, and execute with the email array. Sign up at https://app.jentic.com/sign-up.
Does this API send registration confirmation emails?
No. Sending confirmation emails is the job of the Marketing Single-send API or the Marketing Emails API. This API records the event and attendance state — confirmation send-outs are a separate call.
/marketing/v3/marketing-events/participations/{marketingEventId}/breakdown
Get participation breakdown for an event
/marketing/v3/marketing-events/participations/{externalAccountId}/{externalEventId}/breakdown
Get breakdown by external account and event
/marketing/v3/marketing-events/{objectId}
Retrieve a marketing event by HubSpot object id