HubSpot Marketing Campaigns Public Api

Name: Marketing Campaigns Public 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.

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

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

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.

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.

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