# HubSpot Marketing Events API

**Canonical:** https://apis.io/apis/hubspot/hubspot-marketing-marketing-events-api/  
**Provider:** HubSpot — https://apis.io/providers/hubspot/  
**Base URL:** https://api.hubapi.com  
**Documentation:** https://developers.hubspot.com/docs/api-reference/latest/marketing/marketing-events/guide

HubSpot Marketing Events API is one of 144 APIs that [HubSpot](https://apis.io/providers/hubspot/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 692 JSON Schema definitions. Tagged areas include Marketing and Events. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, and 692 JSON Schemas.

HubSpot Marketing Events — 36 operation(s) from HubSpot's published OpenAPI.

## Operations (36)

| Method | Path | Summary |
|---|---|---|
| GET | `/marketing/marketing-events/2026-09` | — |
| GET | `/marketing/marketing-events/2026-09/associations/{externalAccountId}/{externalEventId}/lists` | Get lists associated with a marketing event |
| PUT | `/marketing/marketing-events/2026-09/associations/{externalAccountId}/{externalEventId}/lists/{listId}` | Associate a list with a marketing event |
| DELETE | `/marketing/marketing-events/2026-09/associations/{externalAccountId}/{externalEventId}/lists/{listId}` | Disassociate a list from a marketing event |
| GET | `/marketing/marketing-events/2026-09/associations/{marketingEventId}/lists` | Get lists associated with a marketing event |
| PUT | `/marketing/marketing-events/2026-09/associations/{marketingEventId}/lists/{listId}` | Associate a list with a marketing event |
| DELETE | `/marketing/marketing-events/2026-09/associations/{marketingEventId}/lists/{listId}` | Disassociate a list from a marketing event |
| POST | `/marketing/marketing-events/2026-09/attendance/{externalEventId}/{subscriberState}/create` | Record Participants by ContactId with Marketing Event External Ids |
| POST | `/marketing/marketing-events/2026-09/attendance/{externalEventId}/{subscriberState}/email-create` | Record Participants by Email with Marketing Event External Ids |
| POST | `/marketing/marketing-events/2026-09/batch/archive` | Delete Multiple Marketing Events by ObjectId |
| POST | `/marketing/marketing-events/2026-09/batch/update` | Update Multiple Marketing Events by ObjectId |
| POST | `/marketing/marketing-events/2026-09/events` | Create a marketing event |
| POST | `/marketing/marketing-events/2026-09/events/delete` | Delete Multiple Marketing Events by External Ids |
| GET | `/marketing/marketing-events/2026-09/events/search` | Find App-Specific Marketing Events by External Event Id |
| POST | `/marketing/marketing-events/2026-09/events/upsert` | Create or Update Multiple Marketing Events |
| GET | `/marketing/marketing-events/2026-09/events/{externalEventId}` | Get Marketing Event by External IDs |
| PUT | `/marketing/marketing-events/2026-09/events/{externalEventId}` | Create or update a marketing event |
| DELETE | `/marketing/marketing-events/2026-09/events/{externalEventId}` | Delete Marketing Event by External Ids |
| PATCH | `/marketing/marketing-events/2026-09/events/{externalEventId}` | Update Marketing Event by External IDs |
| POST | `/marketing/marketing-events/2026-09/events/{externalEventId}/cancel` | Mark a marketing event as cancelled |
| POST | `/marketing/marketing-events/2026-09/events/{externalEventId}/complete` | Mark a marketing event as completed |
| POST | `/marketing/marketing-events/2026-09/events/{externalEventId}/{subscriberState}/email-upsert` | Record a subscriber state by contact email |
| POST | `/marketing/marketing-events/2026-09/events/{externalEventId}/{subscriberState}/upsert` | Record a subscriber state by contact ID |
| GET | `/marketing/marketing-events/2026-09/participations/contacts/{contactIdentifier}/breakdown` | Read participations breakdown by Contact identifier |
| GET | `/marketing/marketing-events/2026-09/participations/{externalAccountId}/{externalEventId}` | Read participations counters by Marketing Event external identifier |
| GET | `/marketing/marketing-events/2026-09/participations/{externalAccountId}/{externalEventId}/breakdown` | Read participations breakdown by Marketing Event external identifier |
| GET | `/marketing/marketing-events/2026-09/participations/{marketingEventId}` | Read participations counters by Marketing Event internal identifier |
| GET | `/marketing/marketing-events/2026-09/participations/{marketingEventId}/breakdown` | Read participations breakdown by Marketing Event internal identifier |
| GET | `/marketing/marketing-events/2026-09/{appId}/settings` | Retrieve the application settings |
| POST | `/marketing/marketing-events/2026-09/{appId}/settings` | Update the application settings |
| GET | `/marketing/marketing-events/2026-09/{externalEventId}/identifiers` | Find Marketing Events by External Event Id |
| GET | `/marketing/marketing-events/2026-09/{objectId}` | Get Marketing Event by objectId |
| DELETE | `/marketing/marketing-events/2026-09/{objectId}` | Delete Marketing Event by objectId |
| PATCH | `/marketing/marketing-events/2026-09/{objectId}` | Update Marketing Event by objectId |
| POST | `/marketing/marketing-events/2026-09/{objectId}/attendance/{subscriberState}/create` | Record Participants by ContactId with Marketing Event Object Id |
| POST | `/marketing/marketing-events/2026-09/{objectId}/attendance/{subscriberState}/email-create` | Record Participants by Email with Marketing Event Object Id |

## Machine-readable artifacts (1066)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-marketing-marketing-events-api-openapi.yml
- **Documentation** — https://developers.hubspot.com/docs/api/cms/domains
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-domain-collection-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-domain-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-forward-paging-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-next-page-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-domain-collection-response-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-domain-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-forward-paging-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-next-page-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-domain-collection-response-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-domain-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-forward-paging-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-next-page-example.json
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/graphql/hubspot-graphql.md
- **Documentation** — https://developers.hubspot.com/docs/api/cms/source-code
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-action-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-asset-file-metadata-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-file-extract-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-file-upload-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-task-locator-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-error-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-result-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-warning-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-action-response-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-asset-file-metadata-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-file-extract-request-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-file-upload-request-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-task-locator-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-error-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-result-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-warning-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-action-response-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-asset-file-metadata-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-file-extract-request-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-file-upload-request-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-task-locator-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-error-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-result-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-warning-example.json
- …and 1026 more, listed in full on the page.

## Other HubSpot APIs (12)

- [HubSpot URL Redirects API](https://apis.io/apis/hubspot/hubspot-url-redirects-api/)
- [HubSpot Pipelines API](https://apis.io/apis/hubspot/hubspot-pipelines-api/)
- [HubSpot Products API](https://apis.io/apis/hubspot/hubspot-products-api/)
- [HubSpot Line Items API](https://apis.io/apis/hubspot/hubspot-line-items-api/)
- [HubSpot Quotes API](https://apis.io/apis/hubspot/hubspot-quotes-api/)
- [HubSpot CRM Properties API](https://apis.io/apis/hubspot/hubspot-crm-properties-api/)
- [HubSpot Owners API](https://apis.io/apis/hubspot/hubspot-owners-api/)
- [HubSpot CRM Imports API](https://apis.io/apis/hubspot/hubspot-crm-imports-api/)
- [HubSpot Custom Objects API](https://apis.io/apis/hubspot/hubspot-custom-objects-api/)
- [HubSpot Marketing Events API](https://apis.io/apis/hubspot/hubspot-marketing-events-api/)
- [HubSpot Forms API](https://apis.io/apis/hubspot/hubspot-forms-api/)
- [HubSpot Workflows API](https://apis.io/apis/hubspot/hubspot-workflows-api/)

## Tags

Marketing, Events

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hubspot/hubspot-marketing-marketing-events-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hubspot/.