Sign in

v

latestOpenAPI 3.1.02026-08-105471692.1 MB
Ad Campaigns

Pause or resume a campaign

Updates the status of all ads in a campaign. Makes one platform API call (not per-ad) since status cascades through the campaign hierarchy. Ads in terminal statuses (rejected, completed, cancelled) are automatically skipped.

put/v1/ads/campaigns/{campaignId}/status

Path parameters

campaignIdstring required

Platform campaign ID

Request body

status'active' | 'paused' required
platform'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai' required

Response

Campaign status updated

updatedinteger

Number of ads updated

skippedinteger

Number of ads skipped

skippedReasonsstring[]
messagestring

Human-readable summary (present when no ads were actionable)