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

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.

Parameters

• campaignId (path, string) required — Platform campaign ID

Request body

Content-Type: application/json

• status (string) required (enum: active, paused)
• platform (string) required (enum: facebook, instagram, tiktok, linkedin, pinterest, google, twitter)

Responses

200 — Campaign status updated

• updated (integer) — Number of ads updated
• skipped (integer) — Number of ads skipped
• skippedReasons (array)
• message (string) — Human-readable summary (present when no ads were actionable)

400 — Invalid input or campaign spans multiple social accounts

401

404 — No ads found for this campaign