Preview catalog activation

​

Request

curl -X POST https://api.interchange.io/api/v2/buyer/advertisers/12345/catalogs/summer-sale-2026/activation-plan/preview \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "save": false }'

​

Parameters

​

Response

{
  "plan": {
    "planId": null,
    "catalogId": "summer-sale-2026",
    "platformCatalogId": "14",
    "catalogVersionId": "42",
    "transformId": "10",
    "planHash": "9f8e7d…",
    "itemCount": 6,
    "campaignGroups": [
      {
        "key": "acme-austin",
        "name": "Acme - Austin",
        "fieldValues": { "city": "Austin", "citySlug": "austin" },
        "itemIds": ["p1", "p2"],
        "itemCount": 2,
        "budget": { "amount": 100, "currency": "USD" }
      }
    ],
    "creativeAssets": [],
    "syndicationTargets": [],
    "createdAt": null
  }
}

• campaignGroups — one per distinct groupBy value, each carrying its derived fieldValues, itemCount, member itemIds, and resolved budget (or null).
• creativeAssets — resolved prompts and cache keys (empty when the transform defines none). This leg is currently gated: it is not surfaced in the buyer UI and is not carried out on execute until brand identity is threaded into generation and output fans out per platform format.
• syndicationTargets — one entry per evaluated seller agent, each with adcpAgentId, shareStatus (ready/unsupported), deliveryMode, usesTransformedCatalog, requiresCreativeAssembly, creativeAgentId (or null), and a human-readable reason. deliveryMode is one of native_catalog, native_creative_catalog, assembled_creative, third_party_creative_agent, or unsupported.

​

Errors

• 400 VALIDATION_ERROR — no active transform exists and none was supplied in the body (“No active catalog transform found. Provide a transform in the request body or save one first.”).
• 404 NOT_FOUND — advertiserId or catalogId does not exist or is not visible to the authenticated account.

​

Related