Reference
google_oauth_failed
A Google sign-in could not be verified.
What it means
A Google sign-in could not be verified.
Retry after fixing
Retrying unchanged will not help. Correct the cause, then send it again.
What causes it
- The ID token was expired, malformed, or issued for a different client id.
- The authorisation code was already exchanged — they are single-use.
- Clock skew between the client and the token's validity window.
How to fix it
- Start the sign-in again rather than replaying the code.
- Confirm the client id in your app matches the one configured on the deployment.
What the response looks like
{
"error": {
"code": "google_oauth_failed",
"message": "A Google sign-in could not be verified",
"request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
},
"type": "https://integrable.cloud/docs/errors/google_oauth_failed",
"title": "Google OAuth Failed",
"status": 401,
"detail": "A Google sign-in could not be verified",
"instance": "/api/bots/01a0652b-3713-7ea1-a6c9-2e895389ec34"
}Branch on error.code, not on the message — the code is stable, the sentence is not. Log request_id either way.
Still stuck
Quote the request_id from the response — hello@integrable.cloud. It is what lets us find the exact request. The full list of codes is at Error codes, and the conventions every endpoint shares are in Retries, versioning and limits.
Something here wrong or missing? Tell us — the documentation and the API are maintained by the same person, so a correction is a fix rather than a ticket.