Skip to main content
A sponsored buyer is a buyer account scoped to your organization’s storefront. The account discovers and transacts only against your inventory and never sees the wider marketplace. The operator may use that account for one or more advertisers (brand care of operator); the sponsored status gates the account, not an individual advertiser identity.
Shareable buyer invite links are retired. You cannot create a new sponsored buyer through a join link. Direct buyers to your verified storefront or Discovery instead. The operations below remain available for sponsorships that already exist; there is no replacement targeted-invitation API.
In the seller UI, find buyers in Advertisers: each is an External advertiser row, and the Needs you filter shows a pending row as awaiting you. This portable Page remains the Account drawer’s and in-chat surface for the sponsored-buyer operations below; it is not a standalone rail destination. Each sponsored buyer carries a status that gates whether it can transact and a seller-selected posture that fixes its billing path. You move status as you onboard, pause, and resume buyers; the buyer cannot override billing. All examples use the storefront base URL:
Authenticate every request with Authorization: Bearer $SCOPE3_API_KEY. Results are scoped to your seller account context — you can only see and manage buyers your organization sponsors.

​
Status lifecycle

A sponsored buyer moves through three states. The status is the transaction gate: only an active buyer can create or edit media buys against your storefront. Allowed transitions:
  • pending → active — Approve a buyer awaiting review.
  • pending or active → suspended — Suspend a buyer to pause new transactions.
  • suspended → active — Reactivate a suspended buyer.
Suspending a buyer blocks new media buys and edits. It does not pause in-flight delivery on media buys that are already running.

​
Key concepts

  • Scope is enforced, not advisory. A sponsored buyer is confined to your storefront at every read and write path — discovery, product details, and media-buy creation. They cannot pin or transact against any other storefront.
  • Billing posture. prepay is Interchange-cleared (BillingParty=agent); credit is seller direct-billed (BillingParty=operator). The posture is fixed at provisioning time and remains under seller governance.
  • Funding boundaries stay unchanged. prepay uses the existing invoice/deposit media-funding mechanisms and does not automate media funding through the platform-fee card rail. credit does not create a Scope3 credit line; the seller invoices the operator directly.
  • Buyer identity. buyerName is the buyer’s company/display name from their account record. It is null when not yet resolvable.

​
Task reference

List sponsored buyers

Every buyer your organization sponsors

Approve sponsored buyer

Admit a pending buyer

Suspend sponsored buyer

Pause an active buyer

Reactivate sponsored buyer

Resume a suspended buyer

All sponsored-buyer tasks

Every operation in one place

Storefront onboarding

End-to-end seller setup

Errors

Shared error contract