Ads

Act on a campaign

Pauses, activates or changes the budget of a campaign.

POST/v1/ad-campaigns/{campaignId}/actions

Coming soon

This route is not in the API yet. This page shows what it will do. Fields, examples and the playground arrive when it ships.

Runs an action on the marketplace: pause, activate or update_budget (with budget.amountInCents and period). The response is 202 with an ad_campaign.action job; follow the result through it.

An ended campaign returns 409. A budget below the marketplace minimum makes the job item fail. Send Idempotency-Key to retry without duplicating.