HubSpot Marketing Campaigns Public API

Name: Marketing Campaigns Public API
Brand: Marketing Campaigns Public API
Availability: InStock

✓ Official Vendor SpecMarketingMarketing Automationoauth224 Endpoints

Install Jentic One Beta

Connect the Marketing Campaigns Public API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Marketing Campaigns Public API, 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 Campaigns Public API.

Create and update campaigns in batches of multiple records per call

Attach assets (emails, pages, social posts) to a campaign by type and id, and detach them when done

Record budget line items against a campaign and update individual budget entries

GET STARTED

Start building with Marketing Campaigns Public API

Explore with Jentic

View OpenAPI Document

For Agents

Manage HubSpot marketing campaigns end-to-end - create, attach assets, record budget and spend, and pull aggregated reporting metrics.

Use for: I need to create a new HubSpot marketing campaign for Q3, Attach a marketing email asset to an existing campaign, Record a $5000 spend entry against a campaign, Pull aggregated reporting metrics for a campaign by guid

Not supported: Does not send emails, render pages, or post to social channels - use for managing campaign metadata, asset attachment, budget, spend, and reporting only.

Use Cases

Patterns agents use Marketing Campaigns Public API for, with concrete tasks.

★ Cross-Asset Campaign Setup

A campaign in HubSpot ties together emails, pages, social posts, and ads under one tracked entity. Use POST /marketing/v3/campaigns/ to create the campaign and POST /marketing/v3/campaigns/{campaignGuid}/assets/{assetType}/{assetId} to attach each asset. Once attached, HubSpot rolls up engagement data per campaign so marketing teams can compare initiatives without stitching reports together manually.

Call POST /marketing/v3/campaigns/ with name=Q3 launch, then POST /marketing/v3/campaigns/{campaignGuid}/assets/EMAIL/{emailId} for each email.

Budget and Spend Tracking

Track the financial side of marketing initiatives by recording budget line items and spend entries against each campaign. Budget endpoints support per-line-item updates plus a totals view, and spend endpoints accept per-entry creates and updates so finance and marketing share a single source of truth. Useful for ROI reporting and quarterly budget reconciliation.

Call POST /marketing/v3/campaigns/{campaignGuid}/budget to add a budget line, then GET /marketing/v3/campaigns/{campaignGuid}/budget/totals to read the rolled-up total.

Performance Reporting Pull

Pull aggregated metrics for a campaign across all its attached assets via GET /marketing/v3/campaigns/{campaignGuid}/reports/metrics. The response combines email opens, page views, form submissions, and other asset-level engagement into a single payload an agent can drop into a dashboard or weekly digest. Useful for automated reporting bots and QBR slide generation.

Call GET /marketing/v3/campaigns/{campaignGuid}/reports/metrics to retrieve aggregated engagement metrics for the campaign.

AI Agent Campaign Reporting via Jentic

An AI agent generates a Monday-morning campaign digest by listing active campaigns, batch-reading metadata, and pulling reporting metrics for each. The agent searches Jentic for HubSpot campaign operations, loads schemas for the list and metrics endpoints, and executes them in parallel. Jentic stores the OAuth token so the agent never handles raw credentials and the digest pipeline stays under a minute.

Search Jentic for "list hubspot campaigns", load schemas for GET /marketing/v3/campaigns/ and GET /marketing/v3/campaigns/{campaignGuid}/reports/metrics, and execute both for each active campaign.

Key Endpoints

24 endpoints — the hubspot marketing campaigns api manages campaigns - the cross-asset organising layer that groups emails, pages, social posts, and ads under a single tracked initiative.

METHOD

PATH

DESCRIPTION

GET

/marketing/v3/campaigns/

List campaigns

POST

/marketing/v3/campaigns/batch/read

Batch-read campaigns by guid

POST

/marketing/v3/campaigns/batch/update

Batch-update campaigns

POST

/marketing/v3/campaigns/{campaignGuid}/assets/{assetType}/{assetId}

Attach an asset to a campaign

POST

/marketing/v3/campaigns/{campaignGuid}/budget

Add a budget line item

GET

/marketing/v3/campaigns/{campaignGuid}/budget/totals

Get aggregated budget totals

POST

/marketing/v3/campaigns/{campaignGuid}/spend/{spendId}

Update a spend entry

GET

/marketing/v3/campaigns/{campaignGuid}/reports/metrics

Get aggregated campaign metrics

GET

/marketing/v3/campaigns/

List campaigns

POST

/marketing/v3/campaigns/batch/read

Batch-read campaigns by guid

POST

/marketing/v3/campaigns/batch/update

Batch-update campaigns

POST

/marketing/v3/campaigns/{campaignGuid}/assets/{assetType}/{assetId}

Attach an asset to a campaign

POST

/marketing/v3/campaigns/{campaignGuid}/budget

Add a budget line item

Why Jentic?

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

Credential isolation

Your HubSpot access 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 'read a HubSpot campaign' or 'get campaign report metrics', and Jentic returns the matching Campaigns operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Marketing Campaigns Public API through Jentic.

What authentication does the Marketing Campaigns 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.

Can I attach an existing marketing email to a campaign?

Yes. Call POST /marketing/v3/campaigns/{campaignGuid}/assets/EMAIL/{emailId}. The asset type segment accepts the HubSpot asset enum (EMAIL, PAGE, SOCIAL, etc.) and the asset id is the existing object's id.

How do I read several campaigns in one call?

Use POST /marketing/v3/campaigns/batch/read with an inputs array of campaign guids. The response returns the matching campaign objects in a single payload, reducing per-record HTTP overhead.

What are the rate limits for the Marketing Campaigns API?

Account-level limits are 100 requests per 10 seconds across HubSpot's authenticated APIs, with daily caps that depend on the subscription tier. Use the batch read and batch update endpoints to fit more campaigns inside the per-second window.

How do I pull campaign metrics through Jentic?

Run pip install jentic, search for "get hubspot campaign metrics", load the schema for GET /marketing/v3/campaigns/{campaignGuid}/reports/metrics, and execute with the campaign guid. Get started with Jentic One, the self-hosted execution layer.

Can I record spend and budget separately on the same campaign?

Yes. Budget line items capture planned amounts (POST /marketing/v3/campaigns/{campaignGuid}/budget) and spend entries capture actuals (POST /marketing/v3/campaigns/{campaignGuid}/spend/{spendId}). The totals endpoint rolls them up for variance reporting.

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

Yes. Because you run Jentic One yourself, your own rules decide which Campaigns operations and credentials the agent may use. Since the campaign guid sits in the URL path (/marketing/v3/campaigns/{campaignGuid}), you can pin the agent to a single campaign and allow only read calls such as GET /marketing/v3/campaigns/{campaignGuid}/budget/totals and GET /marketing/v3/campaigns/{campaignGuid}/reports/metrics. Write operations like attaching assets, adding budget, or recording spend stay blocked unless you explicitly grant them.

HubSpot Marketing Campaigns Public API

Connect the Marketing Campaigns Public API to your agent

Capabilities

Start building with Marketing Campaigns Public API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs