Marketing Emails V3

Name: Marketing Emails V3 API
Brand: Marketing Emails V3
Availability: InStock

✓ Official Vendor SpecMarketingEmail Marketingoauth217 EndpointsREST

For Agents

Newer rollout of the HubSpot marketing email endpoints — manage drafts, AB tests, revisions, and statistics on the rollout-155892 build.

Quickstart

Get started with Marketing Emails V3 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:
"manage hubspot marketing email v3"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Marketing Emails V3 API.

Read and reset the draft of a marketing email on the V3 rollout

Restore a prior revision into the draft slot to roll back content changes

Create an AB-test variation of an email and read it back by source email id

Pull per-email engagement statistics as either a flat list or a time-bucketed histogram

GET STARTED

Start building with Marketing Emails V3 API

Explore with Jentic

View OpenAPI Document

The HubSpot Marketing Emails V3 API is the rollout-155892 build of the marketing email endpoints, covering the same draft, AB-test, revision, publish, and statistics surface but on a newer rollout track. It exposes 17 endpoints for listing emails, reading and resetting drafts, restoring revisions, creating AB-test variations, and pulling per-email statistics as both list and histogram aggregations. Pick this rollout when the consumer needs the latest shape of these endpoints and the matching schema fields.

Use Cases

Patterns agents use Marketing Emails V3 API for, with concrete tasks.

★ Latest-Rollout Editorial Automation

Consume the rollout-155892 shape of the marketing email endpoints when your integration depends on the newest field set and behaviour. Read the draft, run content validation, and reset or restore as needed — all on the V3 rollout. Useful when a parallel team is migrating off the older rollout and you need to point your agent at the new payload shape.

Call GET /marketing/v3/emails/{emailId}/draft on the V3 rollout, validate the content, then POST /marketing/v3/emails/{emailId}/draft/reset if validation fails.

AB Test Setup on the New Rollout

Set up AB tests on the V3 rollout by creating a variation through POST /marketing/v3/emails/ab-test/create-variation and reading it back via the get-variation endpoint. The variation participates in HubSpot's traffic split once published, and the V3 shape carries the latest metadata fields available on test variations.

Call POST /marketing/v3/emails/ab-test/create-variation with the source email id, then GET /marketing/v3/emails/{emailId}/ab-test/get-variation to confirm.

Trend Reporting via Histogram Statistics

Pull a histogram of opens, clicks, and deliveries bucketed over time using GET /marketing/v3/emails/statistics/histogram on the V3 rollout. The bucketed shape avoids client-side aggregation and matches dashboard rendering libraries directly. Useful for weekly trend digests and exec-facing reports.

Call GET /marketing/v3/emails/statistics/histogram with interval=DAY and a 30-day window, then chart the returned buckets.

AI Agent Email Recovery via Jentic

An AI agent restoring an email after an accidental edit lists the email's revisions, picks the prior good revision, and restores it into the draft slot. The agent searches Jentic for revision operations, loads the schema for restore-to-draft, and executes the call. Jentic isolates the OAuth token so the agent handles no raw credentials.

Search Jentic for "restore hubspot email revision", load the schema for POST /marketing/v3/emails/{emailId}/revisions/{revisionId}/restore-to-draft, and execute with the chosen revision id.

Key Endpoints

17 endpoints — the hubspot marketing emails v3 api is the rollout-155892 build of the marketing email endpoints, covering the same draft, ab-test, revision, publish, and statistics surface but on a newer rollout track.

METHOD

PATH

DESCRIPTION

GET

/marketing/v3/emails/{emailId}/draft

Read the current draft

POST

/marketing/v3/emails/{emailId}/draft/reset

Reset the draft to last published

POST

/marketing/v3/emails/ab-test/create-variation

Create an AB-test variation

GET

/marketing/v3/emails/{emailId}/ab-test/get-variation

Get an AB-test variation by source email id

POST

/marketing/v3/emails/{emailId}/revisions/{revisionId}/restore-to-draft

Restore a prior revision into the draft

GET

/marketing/v3/emails/{emailId}/revisions

List revisions for an email

GET

/marketing/v3/emails/statistics/list

List per-email statistics

GET

/marketing/v3/emails/statistics/histogram

Histogram of engagement metrics

GET

/marketing/v3/emails/{emailId}/draft

Read the current draft

POST

/marketing/v3/emails/{emailId}/draft/reset

Reset the draft to last published

POST

/marketing/v3/emails/ab-test/create-variation

Create an AB-test variation

GET

/marketing/v3/emails/{emailId}/ab-test/get-variation

Get an AB-test variation by source email id

POST

/marketing/v3/emails/{emailId}/revisions/{revisionId}/restore-to-draft

Restore a prior revision into the draft

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

HubSpot OAuth and private app tokens are stored encrypted in the Jentic MAXsystem vault. Agents receive scoped execution access — the raw bearer token never enters the agent's context window.

Intent-based discovery

Agents search Jentic with intents like 'restore hubspot email revision' and Jentic returns the matching V3 operation with its input schema, so the agent calls the right rollout endpoint without browsing HubSpot docs.

Time to first call

Direct HubSpot integration: 2-4 days for OAuth setup, rollout selection, draft management, and statistics integration. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Marketing Emails

Older rollout of the same marketing email endpoint surface

Choose the older rollout if existing integrations depend on its payload shape and a migration is not yet planned.

Complementary

Marketing Single-send

Trigger one-off transactional sends of a marketing email

Choose this when the agent needs to fire a single send rather than manage the asset.

Complementary

Marketing Campaigns

Attach marketing emails to campaigns for cross-asset attribution

Choose this when the email belongs to a broader campaign initiative.

Alternative

SendGrid Mail

Delivery-first email API outside the HubSpot ecosystem

Choose SendGrid when delivery and deliverability matter more than HubSpot CRM integration.

FAQs

Specific to using Marketing Emails V3 API through Jentic.

What authentication does the Marketing Emails V3 API use?

It accepts HubSpot OAuth 2.0 access tokens or private app tokens, sent as Bearer in the Authorization header. Through Jentic, the token is stored encrypted in MAXsystem and injected at execution time.

How does V3 differ from the older Marketing Emails endpoints?

V3 is the rollout-155892 build of the same endpoint surface — drafts, AB tests, revisions, statistics — with the latest field shape on responses. Pick V3 when you need the newest payload format; the older rollout remains available for parallel migration.

Can I roll back an email change on the V3 rollout?

Yes. POST /marketing/v3/emails/{emailId}/draft/reset reverts the draft to the last published state, and POST /marketing/v3/emails/{emailId}/revisions/{revisionId}/restore-to-draft brings a specific historical revision into the draft slot.

What are the rate limits for this API?

Account-level limits are 100 requests per 10 seconds across HubSpot's authenticated APIs, with daily caps that depend on the subscription tier. Cache statistics responses in your dashboard layer to reduce repeat reads.

How do I create an AB-test variation through Jentic?

Run pip install jentic, search for "create hubspot email ab test variation", load the schema for POST /marketing/v3/emails/ab-test/create-variation, and execute with the source email id. Sign up at https://app.jentic.com/sign-up.

Does the V3 rollout support sending one-off transactional emails?

No. For single transactional sends use the Marketing Single-send API. V3 manages the marketing email asset lifecycle — drafts, AB tests, revisions, statistics.