Skip to main content
POST /api/v2/buyer/campaigns/:id/pause Halts spend across all media buys and packages on the campaign. The pause cascades to every media buy and package, and the campaign transitions to PAUSED.
To resume a paused campaign, use reactivate — execute does not resume a PAUSED campaign.

​
Request

curl -X POST https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/pause \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
No request body.

​
Parameters

FieldTypeRequiredNotes
idstringYesCampaign ID (path parameter).

​
Response

{
  "campaignId": "cmp_987654321",
  "previousStatus": "ACTIVE",
  "newStatus": "PAUSED",
  "success": true
}
  • The pause halts every media buy and package on the campaign (cascade).
  • campaignId — the campaign that was paused.
  • previousStatus / newStatus — campaign status before and after the call.

​
Errors

CodeWhen
VALIDATION_ERRORCampaign is not in a pausable status.
NOT_FOUNDCampaign ID does not exist for the authenticated customer.
See Errors for the full error shape and recovery semantics.

Reactivate campaign

Resume a PAUSED campaign back to ACTIVE

Execute campaign

Launch a DRAFT or COMPLETED campaign

Media buy status

Poll live ADCP status

Campaign overview

The campaign object and lifecycle