GMAIL_TOKEN_EXCHANGE_FAILED
503upstreamGoogle refused the authorization-code exchange.
Cause
The code was rejected or already consumed, or Google returned no access token.
How to fix it
Restart the connect flow — an authorization code is single-use and cannot be replayed.
Example response
503 GMAIL_TOKEN_EXCHANGE_FAILED
JSON
{
"error_code": "GMAIL_TOKEN_EXCHANGE_FAILED",
"error_type": "upstream",
"error_message": "Google refused the authorization-code exchange.",
"hint": "Restart the connect flow — an authorization code is single-use and cannot be replayed.",
"docs_url": "https://docs.billerapi.com/errors/GMAIL_TOKEN_EXCHANGE_FAILED",
"request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}Related
- Error handling — the error envelope shape and how to parse it
- Error code reference — every stable error code
Canonical docs URL: https://docs.billerapi.com/errors/GMAIL_TOKEN_EXCHANGE_FAILED
Was this page helpful?