Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/event-sources Returns the event sources registered on an advertiser. Each source is an event data pipeline (pixel, SDK, warehouse sync, CRM feed, MMP feed) that log-event references by event_source_id. Register or update sources with Sync event sources.

Request

Parameters

Response

eventTypes is null when the source accepts all types. mapping, integrationPlatform, and testEventCode are Apostra extensions populated by Sync event sources. valueCurrencies, actionSource, and surface are null until declared in a sync; a source without valueCurrencies stays on legacy event compatibility and is not eligible for canonical ROAS. health carries two independent signals, never merged: health.status (not_seen, receiving, or needs_attention) is Scope3’s own observed ingestion pipeline state, updated from accepted or rejected log-event calls. health.grade (insufficient, minimum, good, or excellent) is the AdCP assessment grade, derived from ingestion recency and unresolved errors — a source with no events yet, or whose most recent signal is an unresolved error, is insufficient; one that received events before but nothing in the last 7 days is minimum; within 7 days but not 24 hours is good; within the last 24 hours with no active error is excellent. managedBy is buyer for sources you register through sync, or seller for sources a seller provisions directly; sellerId names the seller account a source has been provisioned on, once known. total is the count matching the query, ignoring pagination.

Errors

  • 404 NOT_FOUND — advertiserId does not exist or is not visible to the authenticated account.
See Errors for the full error contract.

Event source tasks

All event source operations

Log Events guide

How event sources and log-event fit together

Sync event sources

Register or update source configs

Conversion API

Identity-hashing rules and event payloads