Skip to content

Campaign Management API

The Campaign Management API is the advertiser management surface for running paid campaigns across the network: campaigns, ad groups, and creatives, with objectives, budgets, flight dates, and targeting. See Advertisers for the product overview.

https://api.advertising.chat/system/campaigns/*

Availability

Advertiser campaigns are managed-service today — the Advertising.chat team operates this API on your behalf. Self-serve advertiser access is on the roadmap; see Advertisers.

Authentication

Like the Offer Manager API, campaign management authenticates with an Auth0 bearer token and an org scope, with role checks enforced server-side:

Authorization: Bearer <auth0-id-token>
X-Adchat-Target-Org: <orgId>

Resources

Collection Path What it manages
Campaigns /system/campaigns/campaign The flight of activity — objective, budget, and flight dates.
Ad groups /system/campaigns/adGroup Grouping of creatives with shared targeting under a campaign.
Creatives /system/campaigns/creative The rendered ads served by the campaign.

Each collection supports the usual GET, POST, PATCH/PUT, and DELETE. Campaigns and ad groups are created disabled by default and do not spend until launched.

Deprecated flat paths

The older flat management paths (/system/campaign, /system/adGroup, /system/creative) still work but are deprecated in favor of the purpose-named /system/campaigns/* routes above.

Operating it from an agent

The management MCP server exposes campaign, ad group, and creative tools, so an agent can build and launch campaigns from Claude with your own sign-in.