Skip to main content
POST /api/v2/storefront/sponsored-buyers/{buyerId}/approve Approves a pending sponsored buyer, moving it to active. Once active, the buyer can discover and create media buys against your storefront. Buyers that joined through an auto_approve join link are already active and do not need this call.

Request

Parameters

Response

200 OK with the updated SponsoredBuyer:

Errors

  • 400 VALIDATION_ERRORbuyerId is not a positive integer.
  • 401 UNAUTHORIZED — missing or invalid API key.
  • 403 CUSTOMER_ROLE_DENIED — the API key is not a seller account; only sellers manage sponsored buyers.
  • 404 NOT_FOUND — no sponsored buyer with this id under your organization.
  • 409 CONFLICT — the buyer is not pending (for example, already active or suspended).
See Errors for the full error contract.

Sponsored-buyer tasks

All operations

List sponsored buyers

Find a buyer’s id and status

Suspend sponsored buyer

Pause an active buyer

Errors

Shared error contract