Skip to main content
POST /api/v2/buyer/advertisers/{advertiserId}/syndicate Toggles syndication ON or OFF for an audience, 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.

Request

curl -X POST https://api.interchange.io/api/v2/buyer/advertisers/12345/syndicate \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resourceType": "AUDIENCE",
    "resourceId": "aud_88f0",
    "adcpAgentIds": ["42", "57"],
    "enabled": true
  }'

Parameters

FieldTypeRequiredNotes
advertiserIdstring (path)YesAdvertiser that owns the resource
resourceTypeenumYesAUDIENCE, EVENT_SOURCE, or CATALOG
resourceIdstringYesID of the resource being syndicated
adcpAgentIdsstring[]YesOne or more ADCP agent IDs. At least one required
enabledbooleanYestrue turns syndication on, false turns it off

Response

[
  {
    "id": "1",
    "customerId": 7,
    "seatId": "12345",
    "resourceType": "AUDIENCE",
    "resourceId": "aud_88f0",
    "audienceId": "1",
    "eventSourceId": null,
    "catalogId": null,
    "adcpAgentId": "42",
    "adcpAgentAccountId": null,
    "enabled": true,
    "status": "PENDING",
    "errorMessage": null,
    "responseData": null,
    "createdAt": "2026-06-06T17:00:00.000Z",
    "updatedAt": "2026-06-06T17:00:00.000Z",
    "completedAt": null
  }
]
The payload carries one record per agent in adcpAgentIds. Records start at status: "PENDING"; completedAt is null until the async sync finishes.

Errors

  • 400 VALIDATION_ERROR — unknown resourceType, empty adcpAgentIds, or a missing required field.
See Errors for the full error contract.

Syndication tasks

All syndication operations

Get syndication status

Confirm the async sync completed