Execute campaign

POST /api/v2/buyer/campaigns/:id/execute Executes any DRAFT media buys on the campaign, submitting them to ADCP. On a freshly-created campaign the call transitions DRAFT → ACTIVE. You can also call it on an ACTIVE or PAUSED campaign to execute newly-added media buys without affecting the rest of the campaign.

execute submits DRAFT media buys to ADCP. It does not resume a PAUSED campaign — reactivate is the only way to do that. They are different endpoints. COMPLETED and ARCHIVED campaigns cannot be executed.

Request

curl -X POST https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/execute \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "debug": false }'

{
  "debug": false
}

Parameters

Field	Type	Required	Notes
`id`	string	Yes	Campaign ID (path parameter). Must be in `DRAFT`, `ACTIVE`, or `PAUSED` status. `COMPLETED` and `ARCHIVED` campaigns cannot be executed.
`debug`	boolean	No	Defaults to `false`. When `true`, surfaces the raw ADCP request/response and A2A debug logs in each error entry.

Response

{
  "campaignId": "cmp_987654321",
  "success": true,
  "previousStatus": "DRAFT",
  "newStatus": "ACTIVE"
}

When individual media buy submissions fail, success is false and errors[] carries one entry per failure:

{
  "campaignId": "cmp_987654321",
  "success": false,
  "previousStatus": "DRAFT",
  "newStatus": "ACTIVE",
  "errors": [
    {
      "mediaBuyId": "mb_abc123",
      "salesAgentId": "agent_xyz",
      "message": "Sales agent returned 422: invalid format for product"
    }
  ]
}

previousStatus / newStatus — campaign status before and after the call.
errors[] — { mediaBuyId, salesAgentId, message } per failed submission. With debug: true, each entry also includes the full ADCP request/response payloads.

Errors

Code	When
`VALIDATION_ERROR`	Campaign is in `COMPLETED` or `ARCHIVED` status (non-executable), or has no selected products.
`NOT_FOUND`	Campaign ID does not exist for the authenticated account.

See Errors for the full error shape and recovery semantics.

Pause campaign

Halt spend across all media buys

Reactivate campaign

Resume a PAUSED campaign back to ACTIVE

Media buy status

Poll live ADCP status after execute

Campaign overview

The campaign object and lifecycle

Delete campaign Get campaign products

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Pause campaign

Reactivate campaign

Media buy status

Campaign overview

​Request

​Parameters

​Response

​Errors

​Related

Pause campaign

Reactivate campaign

Media buy status

Campaign overview

Request

Parameters

Response

Errors

Related