v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

Ad Campaigns

Pause or resume a single ad

Ad-scoped pause/resume — touches ONLY this ad, never its parent ad set or campaign (so sibling ads keep running). Thin wrapper over the status field of PUT /v1/ads/{adId}, for callers that want a URL symmetric to /v1/ads/campaigns/{campaignId}/status and /v1/ads/ad-sets/{adSetId}/status.

{adId} accepts the same identifier dialects as GET/PUT /v1/ads/{adId} (Zernio hex _id, Meta numeric platformAdId, or the creative's effective story/media IDs). platform is inferred from the ad, so it's not required in the body. Ads in terminal statuses (rejected, completed, cancelled) and no-op flips (already in the target state) are skipped.

put/v1/ads/{adId}/status

Path parameters

adIdstring required

Zernio _id (hex), Meta platformAdId (numeric), or one of the creative's effective story/media IDs.

Request body

status'active' | 'paused' required

Response

Ad status updated (or skipped when no change was needed)

updatedinteger

1 when the status changed, 0 when skipped

skippedinteger

1 when skipped (terminal status or already in target state), else 0

messagestring

Human-readable summary (present only when skipped)