Error Codes

TokenIDP returns OAuth-compatible errors where applicable and may include domain-level validation details for administrative APIs.

OAuth Errors

ErrorMeaning
invalid_requestThe request is malformed or missing required values
invalid_clientClient authentication failed
invalid_grantAuthorization code, refresh token, device code, or request ID is invalid
unauthorized_clientThe client is not allowed to use the requested flow
unsupported_grant_typeThe requested grant is not enabled or supported
invalid_scopeRequested scope is invalid or not allowed

Common Pitfalls

  • Handling every failure as a sign-in failure instead of checking the specific error.
  • Ignoring redirect URI mismatches during authorization code exchange.

Troubleshooting

  • Compare the client registration, allowed grant types, redirect URI, and requested scopes.