Skip to main content
POST /api/v2/buyer/campaigns/:id/auto-select-products For DRAFT campaigns with an attached discovery session, this lets Scope3 pick a balanced product set. Iterate with ADCP-style refinement to nudge the selection toward your plan.

​
Request

curl -X POST https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/auto-select-products \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "maxProducts": 8, "minBudgetPerProduct": 2500 }'

​
Parameters

FieldTypeRequiredNotes
idstringYesCampaign ID (path parameter). Must be DRAFT with a discovery session.
maxProductsnumberNoUpper bound on how many products to select.
minBudgetPerProductnumberNoMinimum budget each selected product must support.
refinearrayNoADCP-style refinement instructions applied to the next selection pass.
refine[].scoperequest | productYes (per entry)request refines the whole selection; product targets a single product.
refine[].askstringFor request scopeFree-text instruction, e.g. "more video, less display".
refine[].idstringFor product scopeProduct ID to act on.
refine[].actioninclude | omit | moreLikeThisFor product scopeinclude keeps this product; omit drops it; moreLikeThis finds similar ones.

​
Response

{
  "campaignId": "cmp_987654321",
  "discoveryId": "disc_abc123",
  "selectedProducts": [
    {
      "productId": "prod_xyz789",
      "name": "Example Media - CTV Premium",
      "salesAgentId": "agent_example",
      "groupId": "grp_1",
      "groupName": "CTV",
      "cpm": 18.5,
      "budget": 25000
    }
  ],
  "budgetContext": {
    "campaignBudget": 100000,
    "totalAllocated": 25000,
    "remainingBudget": 75000,
    "currency": "USD"
  },
  "productCount": 1
}
Read the confirmed selection with Get campaign products.

​
Errors

CodeWhen
VALIDATION_ERRORCampaign is not DRAFT, has no discovery session, or refine entries are malformed.
NOT_FOUNDCampaign ID does not exist for the authenticated customer.
See Errors for the full error shape and recovery semantics.

Discovery

Build the discovery session that feeds selection

Get campaign products

Read the selected products

Execute campaign

Launch the campaign into media buys

Campaign overview

The campaign object and lifecycle