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

curl -X POST https://api.interchange.io/api/v2/storefront/sponsored-buyers/90412/approve \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
buyerIdstring (path)YesThe buyerCustomerId of a buyer your organization sponsors. Must be a positive integer.

​
Response

200 OK with the updated SponsoredBuyer: 
{
  "buyerCustomerId": 90412,
  "buyerName": "Lakeside Motors",
  "storefrontId": 4012,
  "status": "active",
  "posture": "prepay",
  "createdAt": "2026-06-14T18:40:02.118Z"
}

​
Errors

  • 400 VALIDATION_ERROR — buyerId 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