HubSpot Marketing Emails V3
Browse all Hubspot APIs✓ 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.
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.
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.
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.
1
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 | sh2
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 instanceJentic 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
Pull per-email engagement statistics as either a flat list or a time-bucketed histogram
List the revisions of a marketing email so an agent can pick a historical version to restore
Manage the full marketing email asset lifecycle on the latest endpoint rollout
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
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
Why 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.
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.
GET STARTED