Skip to main content
POST /api/v2/buyer/advertisers/{advertiserId}/catalogs/{catalogId}/activation-plan/preview Builds the activation plan a transform would produce from the catalog’s current items — the campaign groups, creative-asset prompts, and seller-syndication targets — without materializing anything. Use it to check the fan-out before you execute. Pass save: true to persist the plan against the latest catalog version so a later refresh can activate it. By default the plan is computed from the catalog’s active transform. Supply an ad hoc transform in the body to preview an unsaved one.

Request

curl

Parameters

FieldTypeRequiredNotes
advertiserIdstring (path)YesUnique identifier for the advertiser
catalogIdstring (path)YesBuyer-assigned catalog_id or the platform catalogId from list catalogs
transformobjectNoAd hoc transform definition to preview. If omitted, the catalog’s active transform is used. Same shape as save catalog transform
adcpAgentIdsarrayNoSeller agents to evaluate for upstream catalog/creative syndication. If omitted, the catalog’s enabled syndication targets are used. Default []
savebooleanNoPersist this plan against the latest catalog version. Requires an active saved transform when transform is omitted. Default false

Response

The plan mirrors the transform’s three parts plus syndication:
  • 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).
  • 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.
When save is false, planId and createdAt are null (nothing is persisted). When save is true, they are populated.

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_FOUNDadvertiserId or catalogId does not exist or is not visible to the authenticated account.
See Errors for the full error contract.

Save catalog transform

Define the fan-out rules

Execute activation

Materialize the plan into jobs

Refresh catalog

Pull the latest feed and re-activate

List catalogs

See synced catalogs