Skip to main content
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

The request has no body.

​
Parameters

​
Response

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 for the full error contract.

Platform accounts and advertiser mapping

Understand account discovery, mapping history, and reconnect states

Open Sellers

Refresh accounts from the new Sellers view