Reference
Errors & Troubleshooting
6 min read·Updated May 7, 2026
A reference for every error Authaz returns. Use it like a debugger: search the page (⌘F / Ctrl+F) for the exact code or message your app is seeing, find the cause, apply the fix.
If your specific error isn't here, the API reference has the canonical response shape and HTTP status semantics.
Sign-in flow errors (OAuth / OIDC)#
These are returned by the OAuth endpoints (/oauth2/authorize, /oauth2/token, /oauth2/userinfo).
| Code | Status | Most likely cause | Fix |
|---|---|---|---|
invalid_request | 400 | The redirect_uri your code sends doesn't match what's registered in Settings → Redirect URIs. The #1 OAuth onboarding bug. | Compare exactly: trailing slash, port, vs , scheme. Add every dev/staging/prod URL. |