Skip to main content
PUT /api/v2/buyer/storefronts/{storefrontId}/selection-override Sets the authenticated buyer account’s selection override for one exact storefront. The caller must have the ADMIN or SUPER_ADMIN account role. The decision controls selection only. Billing capability, direct-billing acceptance, and operator authentication belong to activation, so a selected storefront can still require an activation action before it is usable.

​
Decisions

  • DEFAULT removes the explicit override. Automatic Regional Market Maker and market-maker rules determine selection from the buyer account’s current market-and-channel footprint.
  • ALWAYS_INCLUDE selects the exact storefront account-wide while it remains eligible. It does not apply to sibling storefronts owned by the same seller.
  • ALWAYS_EXCLUDE prevents the exact storefront from being selected.
Hard storefront ineligibility wins over every override. Returning to DEFAULT does not necessarily deselect the storefront; an automatic reason can keep it selected. This control is account-wide. In the Media Partners view for one advertiser, use that advertiser’s Inherit, On, or Off preference instead. An advertiser preference is evaluated only while this account-wide decision is DEFAULT: ALWAYS_INCLUDE and ALWAYS_EXCLUDE remain authoritative for every current and future advertiser. See Update advertiser activation preference.

​
Request

​
Parameters

​
Response

200 OK returns the current decision after the update:
Setting DEFAULT returns "decision": "DEFAULT" after deleting the explicit override.

​
Errors

  • 400 VALIDATION_ERROR — the storefront ID or decision is invalid.
  • 401 UNAUTHORIZED — the bearer token is missing or invalid.
  • 403 FORBIDDEN — the caller is not an account administrator.
  • 404 NOT_FOUND — the storefront is not visible to this buyer account.
See Errors for the full error contract.

Storefront overview

How availability, selection, activation, and billing readiness differ

Storefront tasks

All storefront operations

Advertiser preference

Set Inherit, On, or Off for one advertiser