> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Buyer routing tasks

> Per-operation reference for mapping buyers to GAM advertisers on ad-server-backed sources

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](/v2/storefront/buyer-routing/overview).

## Advertisers

<CardGroup cols={2}>
  <Card title="List GAM advertisers" href="/v2/storefront/buyer-routing/tasks/list-gam-advertisers" icon="list">
    `GET /esa/{esaId}/gam/advertisers` — cached advertiser records
  </Card>

  <Card title="Ensure GAM advertiser" href="/v2/storefront/buyer-routing/tasks/ensure-gam-advertiser" icon="plus">
    `POST /esa/{esaId}/gam/advertisers/ensure` — create or find by name
  </Card>

  <Card title="Set default advertiser" href="/v2/storefront/buyer-routing/tasks/set-default-advertiser" icon="star">
    `PUT /esa/{esaId}/gam/default-advertiser` — the catch-all advertiser
  </Card>
</CardGroup>

## Buyer mappings

<CardGroup cols={2}>
  <Card title="List buyer mappings" href="/v2/storefront/buyer-routing/tasks/list-buyer-mappings" icon="table-list">
    `GET /esa/{esaId}/buyer-advertiser-mappings` — per-buyer overrides
  </Card>

  <Card title="Create buyer mapping" href="/v2/storefront/buyer-routing/tasks/create-buyer-mapping" icon="link">
    `POST /esa/{esaId}/buyer-advertiser-mappings` — route one buyer
  </Card>

  <Card title="Update buyer mapping" href="/v2/storefront/buyer-routing/tasks/update-buyer-mapping" icon="pen">
    `PATCH /esa/{esaId}/buyer-advertiser-mappings/{mappingId}` — edit a mapping
  </Card>

  <Card title="Delete buyer mapping" href="/v2/storefront/buyer-routing/tasks/delete-buyer-mapping" icon="trash">
    `DELETE /esa/{esaId}/buyer-advertiser-mappings/{mappingId}` — remove a mapping
  </Card>
</CardGroup>

## Activity

<CardGroup cols={2}>
  <Card title="List recent buyers" href="/v2/storefront/buyer-routing/tasks/list-recent-buyers" icon="clock-rotate-left">
    `GET /esa/{esaId}/recent-buyers` — buyers seen and how they resolved
  </Card>
</CardGroup>