Skip to main content
Each page below documents a single buyer-routing operation — request, parameters, response shape, and errors. These endpoints apply only to Google Ad Manager-backed embedded sales agents (ESAs): a default advertiser catches all unmatched buyers, and per-buyer mappings override it. For the conceptual model, see the Buyer routing overview.

Advertisers

List GAM advertisers

GET /esa/{esaId}/gam/advertisers — cached advertiser records

Ensure GAM advertiser

POST /esa/{esaId}/gam/advertisers/ensure — create or find by name

Set default advertiser

PUT /esa/{esaId}/gam/default-advertiser — the catch-all advertiser

Buyer mappings

List buyer mappings

GET /esa/{esaId}/buyer-advertiser-mappings — per-buyer overrides

Create buyer mapping

POST /esa/{esaId}/buyer-advertiser-mappings — route one buyer

Update buyer mapping

PATCH /esa/{esaId}/buyer-advertiser-mappings/{mappingId} — edit a mapping

Delete buyer mapping

DELETE /esa/{esaId}/buyer-advertiser-mappings/{mappingId} — remove a mapping

Activity

List recent buyers

GET /esa/{esaId}/recent-buyers — buyers seen and how they resolved