Marketing Campaigns Public Api

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

✓ 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.

Quickstart

Get started with Marketing Campaigns Public Api 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:
"create hubspot marketing campaign"

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

Capabilities

What an agent can do with Marketing Campaigns Public Api 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

GET STARTED

Start building with Marketing Campaigns Public Api API

Explore with Jentic

View OpenAPI Document

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.

Use Cases

Patterns agents use Marketing Campaigns Public Api 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 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 '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.

Complementary

Marketing Emails

The email assets that get attached to campaigns

Choose this when the agent needs to create the email before attaching it to a campaign.

Complementary

Marketing Forms

Forms whose submissions tie back to campaign attribution

Choose this when a campaign needs a lead-capture form attached.

Complementary

CMS Pages

Landing pages attached to campaigns as assets

Choose this when the campaign needs a landing-page asset attached.

Alternative

Mailchimp

Email-first campaign platform with simpler asset model

Choose Mailchimp when the campaign is purely email-driven and does not need cross-asset attribution.

FAQs

Specific to using Marketing Campaigns Public Api 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.