APIHub
Back to Explore

Marketing Events Extension

The Marketing Events Extension API lets you create, retrieve, update, delete, and search marketing events, configure app‑specific settings, and record or up‑sert attendee status (register, attend, cancel) for contacts, including email‑based operations. It also supports bulk upsert and delete of events and marking events as cancelled or completed.

Uncategorized
apiKeyQuery
HTTPS
CORS: Unknown
Description enriched …
Visit official documentation

Latency

364ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
POST

/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/create

Record

  • externalEventId (path, required) — The id of the marketing event
  • subscriberState (path, required) — The new subscriber state for the HubSpot contacts and the specified marketing event. For example: 'register', 'attend' or 'cancel'.
  • externalAccountId (query) — The account id associated with the marketing event
POST

/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create

Record

  • externalEventId (path, required) — The id of the marketing event
  • subscriberState (path, required) — The new subscriber state for the HubSpot contacts and the specified marketing event. For example: 'register', 'attend' or 'cancel'.
  • externalAccountId (query) — The account id associated with the marketing event
POST

/marketing/v3/marketing-events/events

POST

/marketing/v3/marketing-events/events/delete

GET

/marketing/v3/marketing-events/events/search

Search for marketing events

  • q (query, required) — The id of the marketing event in the external event application
POST

/marketing/v3/marketing-events/events/upsert

DELETE

/marketing/v3/marketing-events/events/{externalEventId}

  • externalEventId (path, required)
  • externalAccountId (query, required)
GET

/marketing/v3/marketing-events/events/{externalEventId}

  • externalEventId (path, required)
  • externalAccountId (query, required)
PATCH

/marketing/v3/marketing-events/events/{externalEventId}

  • externalEventId (path, required)
  • externalAccountId (query, required)
PUT

/marketing/v3/marketing-events/events/{externalEventId}

  • externalEventId (path, required)
POST

/marketing/v3/marketing-events/events/{externalEventId}/cancel

  • externalEventId (path, required)
  • externalAccountId (query, required)
POST

/marketing/v3/marketing-events/events/{externalEventId}/complete

  • externalEventId (path, required)
  • externalAccountId (query, required)
POST

/marketing/v3/marketing-events/events/{externalEventId}/{subscriberState}/email-upsert

  • externalEventId (path, required)
  • subscriberState (path, required)
  • externalAccountId (query, required)
POST

/marketing/v3/marketing-events/events/{externalEventId}/{subscriberState}/upsert

  • externalEventId (path, required)
  • subscriberState (path, required)
  • externalAccountId (query, required)
GET

/marketing/v3/marketing-events/{appId}/settings

  • appId (path, required)
POST

/marketing/v3/marketing-events/{appId}/settings

  • appId (path, required)

16 endpoints auto-detected

Authentication

This API uses an API key, passed as the "hapikey" query parameter. No OAuth required.

curl -X POST \
  "https://api.hubapi.com/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/create?hapikey=YOUR_API_KEY"

api.hubapi.com · HTTPS only