HubSpot Marketing Campaigns Public Api
Browse all Hubspot APIs✓ Official Vendor SpecMarketingMarketing Automationoauth224 EndpointsREST
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.
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. It supports listing and reading campaigns, batch creating and updating them, attaching and detaching assets by type and id, recording spend and budget items, and retrieving aggregated reporting metrics on campaign performance. With 24 endpoints across the campaign root, asset, budget, spend, and reporting paths, it gives agents the full lifecycle of a HubSpot campaign object.
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.
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 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
Record spend entries against a campaign and update or remove individual spend items
Retrieve aggregated reporting metrics for a campaign across all attached assets
List and search campaigns with batch-read by id for high-throughput dashboard refreshes
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
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
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 'create hubspot campaign' and Jentic returns the matching operation with its input schema, so the agent calls POST /marketing/v3/campaigns/ with the right payload without browsing HubSpot docs.
Time to first call
Direct HubSpot integration: 2-4 days for OAuth setup, asset attachment logic, batch handling, and reporting 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 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 MAXsystem 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. Sign up at https://app.jentic.com/sign-up.
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.
GET STARTED