HubSpot Marketing Emails V3

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

✓ Official Vendor SpecMarketingEmail Marketingoauth217 EndpointsREST

Install Jentic One Beta

Connect the Marketing Emails V3 to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Marketing Emails V3, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

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

GET STARTED

Start building with Marketing Emails V3 API

Explore with Jentic

View OpenAPI Document

For Agents

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

Use for: I need to read the draft of a marketing email on the V3 rollout, Create an AB-test variation of an email, List the revisions of a marketing email, Restore a specific revision into the draft slot

Not supported: Does not send transactional one-off emails, manage CRM lists, or handle SMS - use for managing marketing email assets on the V3 rollout only.

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 Jentic?

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

Credential isolation

Your HubSpot OAuth or private-app token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'restore a HubSpot email revision' or 'get email A/B test statistics', and Jentic returns the matching V3 operation with its input schema so the agent calls the right endpoint without browsing the HubSpot reference docs.

Time to first call

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 your Jentic One instance 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. Get started with Jentic One, the self-hosted execution layer.

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.

Can I limit what my agent is allowed to do with the HubSpot Marketing Emails V3 API?

Yes. Because you self-host Jentic One, your own rules decide which operations and credentials your agent may use. Since this API carries the email id in the URL path (/marketing/v3/emails/{emailId}/...), a rule can pin the agent to a single marketing email so it reads only that email's drafts, revisions, and A/B test variations. You also choose the exact operations it may call, so write actions like a draft reset (POST /marketing/v3/emails/{emailId}/draft/reset) or a revision restore (POST /marketing/v3/emails/{emailId}/revisions/{revisionId}/restore-to-draft) stay out of reach unless you grant them.

HubSpot Marketing Emails V3

Connect the Marketing Emails V3 to your agent

Capabilities

Start building with Marketing Emails V3 API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs