Skip to main content
PUT /api/v2/storefront/esa/{esaId}/gam/default-advertiser Sets the default Google Ad Manager advertiser for a GAM-backed embedded sales agent. Every incoming buyer that has no matching per-buyer mapping routes to this advertiser. Setting it clears the Default GAM advertiser setup blocker. Call again with a different gamAdvertiserId to replace it.

​
Request

curl -X PUT https://api.interchange.io/api/v2/storefront/esa/123/gam/default-advertiser \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "gamAdvertiserId": "4567890123" }'

​
Parameters

FieldTypeRequiredNotes
esaIdintegerYesPath. Embedded sales-agent connection id
gamAdvertiserIdstringYesGAM advertiser id from list or ensure

​
Response

{
  "defaultGamAdvertiserId": "4567890123"
}
defaultGamAdvertiserId echoes the advertiser now serving as the catch-all for unmatched buyers.

​
Errors

  • 400 VALIDATION_ERROR — gamAdvertiserId is empty, esaId is not a positive integer, or the ESA is not Google Ad Manager-backed.
See Errors for the full error contract.

Buyer routing tasks

All buyer-routing operations

Buyer routing overview

How buyers resolve to advertisers

Ensure GAM advertiser

Provision a catch-all advertiser

Create buyer mapping

Override the default for one buyer