Skip to main content
Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.
POST /api/v2/buyer/advertisers/{advertiserId}/syndicate Toggles syndication ON or OFF for an event source or catalog to one or more ADCP agents. Returns one status record per agent immediately. The sync itself is asynchronous — poll Get syndication status to confirm each record reaches COMPLETED.
v2 no longer sends audiences to sellers. A request with resourceType: "AUDIENCE" and enabled: true is refused with 410 GONE and nothing is saved. Turning audience syndication off (enabled: false) still works. Sending an audience to a seller is moving to the V3 save_audience tool (see Sync a first-party audience).

Request

Parameters

Response

The payload carries one record per agent in adcpAgentIds. Records start at status: "PENDING"; completedAt is null until the async sync finishes. For a seller that has no separate agent record, adcpAgentId is the seller’s public key (for a hosted Storefront, storefront-<platformId>) instead of a numeric id.

Errors

  • 400 VALIDATION_ERROR — unknown resourceType, empty adcpAgentIds, or a missing required field.
  • 410 GONE — resourceType is AUDIENCE and enabled is true. Nothing is saved.
See Errors for the full error contract.

Syndication tasks

All syndication operations

Get syndication status

Confirm the async sync completed