mastra-ai/mastra · error

Failed to fetch user info from Auth0

Error message

Failed to fetch user info from Auth0

What it means

MastraAuthAuth0 verifies a user's access token by calling Auth0's standard /userinfo endpoint (https://<domain>/userinfo) with a 10-second timeout. If the HTTP response status is not OK (e.g. 401 invalid/expired token, 403, 429, 5xx), the provider throws this generic error. It means Auth0 rejected or could not serve the userinfo request for the supplied bearer token.

Source

Thrown at auth/auth0/src/index.ts:636

      const params = new URLSearchParams({
        client_id: self.clientId!,
        returnTo: redirectUri,
      });
      return `https://${self.domain}/v2/logout?${params.toString()}`;
    };
  }

  /**
   * Fetch user info from Auth0's /userinfo endpoint.
   */
  private async _fetchUserInfo(accessToken: string): Promise<EEUser> {
    const userInfoResponse = await fetch(`https://${this.domain}/userinfo`, {
      headers: { Authorization: `Bearer ${accessToken}` },
      signal: AbortSignal.timeout(10_000), // 10 second timeout
    });

    if (!userInfoResponse.ok) {
      throw new Error('Failed to fetch user info from Auth0');
    }

    const userInfo = (await userInfoResponse.json()) as {
      sub: string;
      email?: string;
      name?: string;
      picture?: string;
    };

    return {
      id: userInfo.sub,
      email: userInfo.email,
      name: userInfo.name,
      avatarUrl: userInfo.picture,
    };
  }

  // ============================================================================

View on GitHub (pinned to 75dd419e61)

Solutions

1. Verify the access token is a valid, unexpired Auth0 token for the correct audience — re-authenticate the user to obtain a fresh token.
2. Check the Auth0 domain configuration (options.domain / AUTH0_DOMAIN) matches your tenant, e.g. 'your-tenant.us.auth0.com', with no stray https:// or trailing slash.
3. Log userInfoResponse.status in a local repro to distinguish 401 (bad token) from 403/429/5xx (permissions, rate limit, outage).
4. Confirm network egress: the provider hits https://<domain>/userinfo with a 10s timeout; ensure proxies/firewalls allow it.

Example fix

// before: token minted for wrong audience, 401 on /userinfo
const auth = new MastraAuthAuth0({ domain: 'wrong-tenant.auth0.com' });

// after: correct tenant domain and fresh audience-correct token
const auth = new MastraAuthAuth0({ domain: 'my-tenant.us.auth0.com' });
// client obtains token with audience matching the API registered in Auth0

if (!accessToken || !domain) throw new Error('Auth0 access token and domain are required before verifying user info');

function isAuth0AuthError(e: unknown): e is Error & { message: 'Failed to fetch user info from Auth0' } {
  return e instanceof Error && e.message === 'Failed to fetch user info from Auth0';
}

try {
  await authConfig.verifyToken(token);
} catch (e) {
  if (isAuth0AuthError(e)) {
    // treat as 401: force client re-authentication
    return respondUnauthorized('Auth0 rejected the token; re-authenticate');
  }
  throw e;
}

When it happens

Trigger: Any call path that resolves user info (e.g. authenticateUser/verifyToken) where fetch(`https://${this.domain}/userinfo`, { headers: { Authorization: Bearer <accessToken> } }) returns userInfoResponse.ok === false — expired/revoked/malformed access token, wrong Auth0 domain, audience mismatch, network/gateway errors, or the 10s AbortSignal.timeout firing (which surfaces as a fetch rejection/timeout before this throw, but non-2xx triggers the throw).

Common situations: Misconfigured AUTH0_DOMAIN env var (typo or wrong tenant), access tokens issued for a different API audience than the domain expects, expired or revoked tokens forwarded from the client, Auth0 tenant outages or rate limiting (429), and self-signed/corporate proxy TLS failures.

Related errors

• Token exchange failed: ${error}
• Invalid state token format
• Invalid or tampered state token
• Invalid state token payload
• Redirect URI is required for SSO. Set AUTH0_REDIRECT_URI or

AI-assisted analysis of mastra-ai/mastra@75dd419e61 (2026-08-30). Data as JSON: /api/errors/eaf3ceebbd4d19a2. Report an issue: GitHub.