# HubSpot Marketing Emails API

**Canonical:** https://apis.io/apis/hubspot/hubspot-marketing-marketing-emails-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-emails/guide

HubSpot Marketing Emails 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 Emails. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, and 692 JSON Schemas.

HubSpot Marketing Emails — 19 operation(s) from HubSpot's published OpenAPI.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/marketing/emails/2026-09` | — |
| POST | `/marketing/emails/2026-09` | — |
| POST | `/marketing/emails/2026-09/ab-test/create-variation` | Create an A/B test variation of a marketing email |
| POST | `/marketing/emails/2026-09/clone` | Clone a marketing email |
| GET | `/marketing/emails/2026-09/statistics/histogram` | Get aggregated statistic intervals |
| GET | `/marketing/emails/2026-09/statistics/list` | Get aggregated statistics |
| GET | `/marketing/emails/2026-09/{emailId}` | Get the details of a specified marketing email |
| DELETE | `/marketing/emails/2026-09/{emailId}` | Delete a marketing email |
| PATCH | `/marketing/emails/2026-09/{emailId}` | Update a marketing email |
| GET | `/marketing/emails/2026-09/{emailId}/ab-test/get-variation` | Get the variation of a an A/B marketing email |
| GET | `/marketing/emails/2026-09/{emailId}/draft` | Get draft version of a marketing email |
| PATCH | `/marketing/emails/2026-09/{emailId}/draft` | Create or update draft version |
| POST | `/marketing/emails/2026-09/{emailId}/draft/reset` | Reset the draft version |
| POST | `/marketing/emails/2026-09/{emailId}/publish` | Publish or send a marketing email |
| GET | `/marketing/emails/2026-09/{emailId}/revisions` | Get revisions of a marketing email |
| GET | `/marketing/emails/2026-09/{emailId}/revisions/{revisionId}` | Get a revision of a marketing email |
| POST | `/marketing/emails/2026-09/{emailId}/revisions/{revisionId}/restore` | Restore a revision of a marketing email |
| POST | `/marketing/emails/2026-09/{emailId}/revisions/{revisionId}/restore-to-draft` | Restore a revision of a marketing email to DRAFT state |
| POST | `/marketing/emails/2026-09/{emailId}/unpublish` | Unpublish or cancel a marketing email |

## Machine-readable artifacts (1066)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-marketing-marketing-emails-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, Emails

---

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