> ## 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.

# Refresh provider accounts

> Rediscover accounts visible to saved provider credentials without reconnecting

`POST /api/v2/buyer/storefront-connections/{connectionId}/accounts/refresh`

Refreshes the accounts visible to an existing official-adapter connection by
reusing every active credential grant. Use it after provider-side access
changes, such as adding a client under a Google MCC or granting another Meta ad
account.

Newly visible accounts are added. An account that is no longer visible stays in
connection history, while its advertiser mapping is retained and marked
unreachable. Reconnect only when the response says a saved credential needs
attention.

## Request

```bash theme={null}
curl -X POST \
  "https://api.interchange.io/api/v2/buyer/storefront-connections/901/accounts/refresh" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

The request has no body.

## Parameters

| Field          | In   | Type    | Required | Notes                                     |
| -------------- | ---- | ------- | -------- | ----------------------------------------- |
| `connectionId` | path | integer | Yes      | Buyer-visible official-adapter connection |

## Response

```json theme={null}
{
  "connectionId": "901",
  "accountCount": 3,
  "selectedAccountId": "1204",
  "refreshedAt": "2026-08-24T09:00:00.000Z"
}
```

`accountCount` is the number of accounts returned by this refresh.
`selectedAccountId` is `null` when no refreshed account is selected or when
multiple credential grants each have a selected account.

## Errors

* `400 VALIDATION_ERROR` — the connection has no healthy saved credential, or a
  grant needs attention. Inspect `details.reconnectRequired`; when it is `true`,
  reauthorize or update the API key before retrying.
* `401 UNAUTHORIZED` — the bearer token is missing or invalid.
* `404 NOT_FOUND` — the connection is unavailable to the authenticated buyer.
* `429 RATE_LIMITED` — provider discovery was throttled; retry with backoff.
* `503 SERVICE_UNAVAILABLE` — provider discovery is temporarily unavailable;
  retry later.

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

## Related

<CardGroup cols={2}>
  <Card title="Platform accounts and advertiser mapping" href="/v2/concepts/ad-platform-accounts" icon="sitemap">
    Understand account discovery, mapping history, and reconnect states
  </Card>

  <Card title="Open Sellers" href="/v2/buyer/storefronts/tasks/open-connections-page" icon="plug">
    Refresh accounts from the new Sellers view
  </Card>
</CardGroup>