Reference

google_oauth_failed

A Google sign-in could not be verified.

401HTTP 401 · Google OAuth Failed

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

401 application/problem+json
{
  "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.

Building on it? Start on the free plan — no card — and call the same API the dashboard uses.

Start free