Skip to main content
POST
/
campaigns
/
{campaignId}
/
execute
Execute campaign
curl --request POST \
  --url https://api.interchange.io/api/v2/buyer/campaigns/{campaignId}/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "debug": true
}'
{
  "campaignId": "cmp_987654321",
  "previousStatus": "DRAFT",
  "newStatus": "DRAFT",
  "success": true,
  "errors": [
    {
      "mediaBuyId": "<string>",
      "salesAgentId": "<string>",
      "message": "<string>",
      "debug": {
        "request": {},
        "response": {},
        "debugLogs": [
          {}
        ],
        "error": "<string>"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.interchange.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key or access token

Path Parameters

​
id
string
required

Unique identifier for the campaign

Minimum string length: 1
Example:

"cmp_987654321"

Body

application/json

Optional request body for executing a campaign

​
debug
boolean

When true, includes detailed debug information in error responses from media buy execution

Response

Execute campaign

Response from executing or pausing a campaign

​
campaignId
string
required

Campaign ID

Example:

"cmp_987654321"

​
previousStatus
enum<string>
required

Previous campaign status

Available options:
DRAFT,
ACTIVE,
PAUSED,
COMPLETED,
ARCHIVED
​
newStatus
enum<string>
required

New campaign status

Available options:
DRAFT,
ACTIVE,
PAUSED,
COMPLETED,
ARCHIVED
​
success
boolean
required

Whether the status change was fully successful. False when any media buy execution failed.

​
errors
object[]

Structured error details per failed media buy. Only present when there are failures.