> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Suspend sponsored buyer

> Pause a sponsored buyer so it can no longer start new transactions

`POST /api/v2/storefront/sponsored-buyers/{buyerId}/suspend`

Suspends a sponsored buyer, moving it to `suspended`. A suspended buyer cannot create or edit media buys against your storefront. You can suspend a buyer that is either `pending` or `active`.

<Note>
  Suspending blocks **new** media buys and edits. It does not pause in-flight delivery on media buys that are already running.
</Note>

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.interchange.io/api/v2/storefront/sponsored-buyers/90377/suspend \
    -H "Authorization: Bearer $SCOPE3_API_KEY"
  ```
</CodeGroup>

## Parameters

| Field     | Type          | Required | Notes                                                                                    |
| --------- | ------------- | -------- | ---------------------------------------------------------------------------------------- |
| `buyerId` | string (path) | Yes      | The `buyerCustomerId` of a buyer your organization sponsors. Must be a positive integer. |

## Response

`200 OK` with the updated `SponsoredBuyer`:

```json theme={null}
{
  "buyerCustomerId": 90377,
  "buyerName": "Corner Slice",
  "storefrontId": 4012,
  "status": "suspended",
  "posture": "prepay",
  "createdAt": "2026-06-12T09:15:44.901Z"
}
```

## 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 already `suspended`.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Sponsored-buyer tasks" href="/v2/storefront/sponsored-buyers/tasks" icon="list-check">
    All operations
  </Card>

  <Card title="Reactivate sponsored buyer" href="/v2/storefront/sponsored-buyers/tasks/reactivate-sponsored-buyer" icon="rotate-right">
    Resume a suspended buyer
  </Card>

  <Card title="List sponsored buyers" href="/v2/storefront/sponsored-buyers/tasks/list-sponsored-buyers" icon="list">
    Find a buyer's id and status
  </Card>

  <Card title="Errors" href="/v2/reference/errors" icon="triangle-exclamation">
    Shared error contract
  </Card>
</CardGroup>