Skip to main content
POST
Sync event sources

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

Body

application/json

Request body for syncing event sources (ADCP spec). Omitting event_sources makes the call discovery-only.

account
object
required

Advertiser account to sync event sources onto

idempotency_key
string

Client-generated unique key for at-most-once execution. Prevents duplicate audit events and downstream provisioning on retry. Also serves as a request ID on discovery-only calls. Strongly recommended; omitting it means retries are not deduplicated.

Required string length: 16 - 255
Pattern: ^[A-Za-z0-9_.:-]{16,255}$
event_sources
object[]

Event sources to sync (up to 50 per call). When omitted, the call is discovery-only: it returns every existing event source on the account without modification.

Required array length: 1 - 50 elements
delete_missing
boolean
default:false

Archive buyer-managed event sources not included in this request. Has no effect when event_sources is omitted (discovery-only).

Response

Sync event sources

Response from sync_event_sources

event_sources
object[]
required

Per-source sync results