@auth0/auth0-spa-js

  • Version 2.30.0
  • Published
  • 5.59 MB
  • 4 dependencies
  • MIT license

Install

npm i @auth0/auth0-spa-js
yarn add @auth0/auth0-spa-js
pnpm add @auth0/auth0-spa-js

Overview

Auth0 SDK for Single Page Applications using Authorization Code Grant Flow with PKCE

Index

Variables

Functions

Classes

Interfaces

Enums

Type Aliases

Variables

variable RefreshTokenMode

const RefreshTokenMode: { readonly Offline: 'offline'; readonly Online: 'online' };

Functions

function createAuth0Client

createAuth0Client: {
(
options: Auth0ClientOptions & {
refreshTokenMode: 'online';
useRefreshTokens: true;
useDpop: true;
}
): Promise<Auth0Client>;
(
options: Auth0ClientOptions & { refreshTokenMode?: 'offline' }
): Promise<Auth0Client>;
};
  • Online mode requires useRefreshTokens: true and useDpop: true, enforced here at compile time. Dynamic values, casts, and plain JS are covered by the runtime check in the Auth0Client constructor.

    Getting Started

function isFederatedDomain

isFederatedDomain: (
auth0Domain: string,
emailDomain: string,
options?: IsFederatedDomainOptions
) => Promise<boolean>;
  • Checks whether an email domain is managed for enterprise SSO on the given Auth0 tenant. Wraps the auth-js primitive to inject spa-js telemetry by default.

    Parameter auth0Domain

    Tenant domain, e.g. 'tenant.auth0.com'. A leading 'https://' or 'http://' is stripped automatically.

    Parameter emailDomain

    The email domain to check, e.g. 'acme.com'.

Classes

class AnonymousSessionApiClient

class AnonymousSessionApiClient {}
  • Browser-layer wrapper around auth0-auth-js AnonymousSessionClient.

    Adds local session storage (localStorage or memory) so callers never need to manage the session token themselves. getTokenSilently() returns a cached access token when still valid and renews it transparently when expired.

    The session token is stored once and shared across all audience/scope slots. Each slot stores only its own access token and expiry.

    Exposed on Auth0Client as auth0.anonymous.

    Clients

constructor

constructor(
authJsClient: AnonymousSessionClient,
clientId: string,
cacheMode?: 'localStorage' | 'memory',
lockManager?: ILockManager
);

    method createSession

    createSession: (
    options?: CreateAnonymousSessionOptions
    ) => Promise<AnonymousSession>;
    • Creates a new anonymous session and persists the tokens locally.

    method getClaims

    getClaims: () => null;
    • Always returns null in EA — session tokens are issued as opaque JWEs and cannot be decoded client-side. Reserved for future JWT format support.

    method getTokenSilently

    getTokenSilently: (
    options?: AnonymousGetTokenSilentlyOptions
    ) => Promise<AnonymousTokenResult>;
    • Returns a valid anonymous access token, renewing it when expired.

      If the stored access token is still fresh (more than 60 s remaining), it is returned directly without a network call. Otherwise the session token is used to re-mint the access token. If the session token has also expired, the local cache is cleared and an AnonymousSessionError with code session_expired is thrown — call createSession() to start a new session.

      Throws

      {AnonymousSessionError} with code session_expired if the session token has expired.

    method hasSession

    hasSession: () => boolean;
    • Returns true if a session token exists in the local cache.

    method logout

    logout: () => Promise<void>;
    • Ends the anonymous session and clears all locally stored tokens.

    method mintTransferToken

    mintTransferToken: () => Promise<string | null>;
    • Mints a short-lived transfer ticket (30s single-use JWE) for linking the anonymous session during loginWithRedirect(). Returns null if no session is active or the request fails — callers must never be blocked from login.

    class Auth0Client

    class Auth0Client {}
    • Auth0 SDK for Single Page Applications using [Authorization Code Grant Flow with PKCE](https://auth0.com/docs/api-auth/tutorials/authorization-code-grant-pkce).

      Clients

    constructor

    constructor(options: Auth0ClientOptions);
    • Constructor

    property anonymous

    readonly anonymous: AnonymousSessionApiClient;
    • Anonymous Sessions client.

      Use anonymous.createSession() to establish an anonymous identity before the user logs in. Use anonymous.getTokenSilently() to obtain or silently renew the access token. Use anonymous.logout() to end the anonymous session. Use anonymous.getClaims() to read decoded session token claims (always null in EA).

      Sub-clients

    property mfa

    readonly mfa: MfaApiClient;
    • MFA API client for multi-factor authentication operations.

      Provides methods for: - Listing enrolled authenticators - Enrolling new authenticators (OTP, SMS, Voice, Push, Email) - Initiating MFA challenges - Verifying MFA challenges

      Sub-clients

    property myAccount

    readonly myAccount: MyAccountApiClient;
    • Sub-clients

    property passkey

    readonly passkey: PasskeyApiClient;
    • Passkey API client for passwordless authentication.

      Provides two single-call methods that handle the full WebAuthn flow internally: - signup(options) — register a new user with a passkey - login(options?) — authenticate an existing user with a passkey

      Sub-clients

    method checkSession

    checkSession: (options?: GetTokenSilentlyOptions) => Promise<void>;
    • await auth0.checkSession();

      Check if the user is logged in using getTokenSilently. The difference with getTokenSilently is that this doesn't return a token, but it will pre-fill the token cache.

      This method also heeds the auth0.{clientId}.is.authenticated cookie, as an optimization to prevent calling Auth0 unnecessarily. If the cookie is not present because there was no previous login (or it has expired) then tokens will not be refreshed.

      It should be used for silently logging in the user when you instantiate the Auth0Client constructor. You should not need this if you are using the createAuth0Client factory.

      **Note:** the cookie **may not** be present if running an app using a private tab, as some browsers clear JS cookie data and local storage when the tab or page is closed, or on page reload. This effectively means that checkSession could silently return without authenticating the user on page refresh when using a private tab, despite having previously logged in. As a workaround, use getTokenSilently instead and handle the possible login_required error [as shown in the readme](https://github.com/auth0/auth0-spa-js#creating-the-client).

      Parameter options

      Authentication

    method connectAccountWithRedirect

    connectAccountWithRedirect: <TAppState = any>(
    options: RedirectConnectAccountOptions<TAppState>
    ) => Promise<void>;
    • Initiates a redirect to connect the user's account with a specified connection. This method generates PKCE parameters, creates a transaction, and redirects to the /connect endpoint.

      You must enable Offline Access from the Connection Permissions settings to be able to use the connection with Connected Accounts.

      TAppState - The application state to persist through the transaction.

      Parameter options

      Options for the connect account redirect flow.

      Parameter

      {string} options.connection - The name of the connection to link (e.g. 'google-oauth2').

      Parameter

      {string[]} [options.scopes] - Array of scopes to request from the Identity Provider during the connect account flow.

      Parameter

      {AuthorizationParams} [options.authorization_params] - Additional authorization parameters for the request to the upstream IdP.

      Parameter

      {string} [options.redirectUri] - The URI to redirect back to after connecting the account.

      Parameter

      {TAppState} [options.appState] - Application state to persist through the transaction.

      Parameter

      {(url: string) => Promise} [options.openUrl] - Custom function to open the URL.

      Returns

      {Promise} Resolves when the redirect is initiated.

      Throws

      {MyAccountApiError} If the connect request to the My Account API fails.

      Connected Accounts

    method createFetcher

    createFetcher: <TOutput extends CustomFetchMinimalOutput = Response>(
    config?: FetcherConfig<TOutput>
    ) => Fetcher<TOutput>;
    • Returns a new Fetcher class that will contain a fetchWithAuth() method. This is a drop-in replacement for the Fetch API's fetch() method, but will handle certain authentication logic for you, like building the proper auth headers or managing DPoP nonces and retries automatically.

      Check the EXAMPLES.md file for a deeper look into this method.

      Advanced

    method customTokenExchange

    customTokenExchange: (
    options: CustomTokenExchangeOptions
    ) => Promise<TokenEndpointResponse>;
    • await auth0.customTokenExchange(options);

      Exchanges an external subject token for Auth0 tokens without affecting the current session.

      Unlike loginWithCustomTokenExchange, this method has no side effects — it does not cache tokens, does not update the authenticated session, and does not affect isAuthenticated() or getUser(). Use this for delegation or impersonation scenarios where you need a token for a downstream API but do not want to change who the current user is.

      When a Web Worker is configured, the refresh_token is discarded inside the worker and never reaches the main thread. When no Web Worker is configured, the raw authorization server response is returned — if a refresh_token is present, discard it; this method intentionally does not store it.

      Parameter options

      The options required to perform the token exchange.

      Returns

      {Promise} A promise that resolves to the token endpoint response.

      **Example:**

      const tokenResponse = await auth0.customTokenExchange({
      subject_token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...',
      subject_token_type: 'urn:acme:legacy-system-token',
      actor_token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...',
      actor_token_type: 'https://idp.example.com/token-type/agent',
      audience: 'https://api.example.com',
      });
      // Use tokenResponse.access_token to call downstream API
      // Current user session is unchanged

      Tokens

    method exchangeToken

    exchangeToken: (
    options: CustomTokenExchangeOptions
    ) => Promise<TokenEndpointResponse>;
    • Parameter options

      The options required to perform the token exchange.

      Returns

      {Promise} A promise that resolves to the token endpoint response.

      **Example:**

      // Instead of:
      const tokens = await auth0.exchangeToken(options);
      // Use:
      const tokens = await auth0.loginWithCustomTokenExchange(options);

      Tokens

      Deprecated

      Use loginWithCustomTokenExchange() instead. This method will be removed in the next major version.

      Exchanges an external subject token for Auth0 tokens.

    method generateDpopProof

    generateDpopProof: (params: {
    url: string;
    method: string;
    nonce?: string;
    accessToken: string;
    }) => Promise<string>;
    • Returns a string to be used to demonstrate possession of the private key used to cryptographically bind access tokens with DPoP.

      It requires enabling the Auth0ClientOptions.useDpop option.

      Advanced

    method getConfiguration

    getConfiguration: () => Readonly<ClientConfiguration>;
    • Returns a readonly copy of the initialization configuration.

      Returns

      An object containing domain and clientId

      Example 1

      const auth0 = new Auth0Client({
      domain: 'tenant.auth0.com',
      clientId: 'abc123'
      });
      const config = auth0.getConfiguration();
      // { domain: 'tenant.auth0.com', clientId: 'abc123' }

      Advanced

    method getDpopNonce

    getDpopNonce: (id?: string) => Promise<string | undefined>;
    • Returns the current DPoP nonce used for making requests to Auth0.

      It can return undefined because when starting fresh it will not be populated until after the first response from the server.

      It requires enabling the Auth0ClientOptions.useDpop option.

      Parameter nonce

      The nonce value.

      Parameter id

      The identifier of a nonce: if absent, it will get the nonce used for requests to Auth0. Otherwise, it will be used to select a specific non-Auth0 nonce.

      Advanced

    method getIdTokenClaims

    getIdTokenClaims: () => Promise<IdToken | undefined>;
    • const claims = await auth0.getIdTokenClaims();

      Returns all claims from the id_token if available.

      User Profile

    method getTokenSilently

    getTokenSilently: {
    (options: GetTokenSilentlyOptions & { detailedResponse: true }): Promise<
    GetTokenSilentlyVerboseResponse | undefined
    >;
    (options?: GetTokenSilentlyOptions): Promise<string>;
    };
    • Fetches a new access token and returns the response from the /oauth/token endpoint, omitting the refresh token.

      Parameter options

      Tokens

    • Fetches a new access token and returns it.

      Parameter options

      Tokens

    method getTokenWithPopup

    getTokenWithPopup: (
    options?: GetTokenWithPopupOptions,
    config?: PopupConfigOptions
    ) => Promise<string | undefined>;
    • const token = await auth0.getTokenWithPopup(options);

      Opens a popup with the /authorize URL using the parameters provided as arguments. Random and secure state and nonce parameters will be auto-generated. If the response is successful, results will be valid according to their expiration times.

      Parameter options

      Parameter config

      Tokens

    method getUser

    getUser: <TUser extends User>() => Promise<TUser | undefined>;
    • const user = await auth0.getUser();

      Returns the user information if available (decoded from the id_token).

    method handleRedirectCallback

    handleRedirectCallback: <TAppState = any>(
    url?: string
    ) => Promise<
    RedirectLoginResult<TAppState> | ConnectAccountRedirectResult<TAppState>
    >;
    • After the browser redirects back to the callback page, call handleRedirectCallback to handle success and error responses from Auth0. If the response is successful, results will be valid according to their expiration times.

      Authentication

    method isAuthenticated

    isAuthenticated: () => Promise<boolean>;
    • const isAuthenticated = await auth0.isAuthenticated();

      Returns true if there's valid information stored, otherwise returns false.

      Authentication

    method loginWithCustomTokenExchange

    loginWithCustomTokenExchange: (
    options: CustomTokenExchangeOptions
    ) => Promise<TokenEndpointResponse>;
    • await auth0.loginWithCustomTokenExchange(options);

      Exchanges an external subject token for Auth0 tokens and logs the user in. This method implements the Custom Token Exchange grant as specified in RFC 8693.

      The exchanged tokens are automatically cached, establishing an authenticated session. After calling this method, you can use getUser(), getIdTokenClaims(), and getTokenSilently() to access the user's information and tokens.

      Parameter options

      The options required to perform the token exchange.

      Returns

      {Promise} A promise that resolves to the token endpoint response, which contains the issued Auth0 tokens (access_token, id_token, etc.).

      The request includes the following parameters: - grant_type: "urn:ietf:params:oauth:grant-type:token-exchange" - subject_token: The external token to exchange - subject_token_type: The type identifier of the external token - scope: Merged scopes from the request and SDK defaults - audience: Target audience (defaults to SDK configuration) - organization: Optional organization ID/name for org-scoped authentication

      **Example Usage:**

      const options = {
      subject_token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...',
      subject_token_type: 'urn:acme:legacy-system-token',
      scope: 'openid profile email',
      audience: 'https://api.example.com',
      organization: 'org_12345'
      };
      try {
      const tokenResponse = await auth0.loginWithCustomTokenExchange(options);
      console.log('Access token:', tokenResponse.access_token);
      // User is now logged in - access user info
      const user = await auth0.getUser();
      console.log('Logged in user:', user);
      } catch (error) {
      console.error('Token exchange failed:', error);
      }

      Tokens

    method loginWithPopup

    loginWithPopup: (
    options?: PopupLoginOptions,
    config?: PopupConfigOptions
    ) => Promise<void>;
    • try {
      await auth0.loginWithPopup(options);
      } catch(e) {
      if (e instanceof PopupCancelledError) {
      // Popup was closed before login completed
      }
      }

      Opens a popup with the /authorize URL using the parameters provided as arguments. Random and secure state and nonce parameters will be auto-generated. If the response is successful, results will be valid according to their expiration times.

      IMPORTANT: This method has to be called from an event handler that was started by the user like a button click, for example, otherwise the popup will be blocked in most browsers.

      Parameter options

      Parameter config

      Authentication

    method loginWithRedirect

    loginWithRedirect: <TAppState = any>(
    options?: RedirectLoginOptions<TAppState>
    ) => Promise<void>;
    • await auth0.loginWithRedirect(options);

      Performs a redirect to /authorize using the parameters provided as arguments. Random and secure state and nonce parameters will be auto-generated.

      Parameter options

      Authentication

    method logout

    logout: (options?: LogoutOptions) => Promise<void>;
    • await auth0.logout(options);

      Clears the application session and performs a redirect to /v2/logout, using the parameters provided as arguments, to clear the Auth0 session.

      If the federated option is specified it also clears the Identity Provider session. [Read more about how Logout works at Auth0](https://auth0.com/docs/logout).

      Parameter options

      Authentication

    method revokeRefreshToken

    revokeRefreshToken: (options?: RevokeRefreshTokenOptions) => Promise<void>;
    • await auth0.revokeRefreshToken();

      Revokes the refresh token using the /oauth/revoke endpoint. This invalidates the refresh token so it can no longer be used to obtain new access tokens.

      The method works with both memory and localStorage cache modes: - For memory storage with worker: The refresh token never leaves the worker thread, maintaining security isolation - For localStorage: The token is retrieved from cache and revoked

      If useRefreshTokens is disabled, this method does nothing.

      **Online mode:** when refreshTokenMode is 'online', revoking the ORT via /oauth/revoke **also terminates the Auth0 session** and **clears the entire local cache** (access token, ID token, user profile). Because Online Refresh Tokens are session-bound, the authorization server ties the token directly to the session — revoking the ORT invalidates the session server-side. The local cache is cleared immediately so that isAuthenticated() returns false and getUser() returns undefined right away, without waiting for the access token to expire. Use this when you need to force a sign-out without a redirect (e.g. background revocation). For a redirect-based sign-out, prefer logout().

      **Important:** This method revokes the refresh token for a single audience. If your application requests tokens for multiple audiences, each audience may have its own refresh token. To fully revoke all refresh tokens, call this method once per audience. If you want to terminate the user's session with a redirect, use logout() instead.

      When using Multi-Resource Refresh Tokens (MRRT), a single refresh token may cover multiple audiences. In that case, revoking it will affect all cache entries that share the same token.

      Parameter options

      Optional parameters to identify which refresh token to revoke. Defaults to the audience configured in authorizationParams.

      Example 1

      // Revoke the default refresh token await auth0.revokeRefreshToken();

      Example 2

      // Revoke refresh tokens for each audience individually await auth0.revokeRefreshToken({ audience: 'https://api.example.com' }); await auth0.revokeRefreshToken({ audience: 'https://api2.example.com' });

      Tokens

    method setDpopNonce

    setDpopNonce: (nonce: string, id?: string) => Promise<void>;
    • Sets the current DPoP nonce used for making requests to Auth0.

      It requires enabling the Auth0ClientOptions.useDpop option.

      Parameter nonce

      The nonce value.

      Parameter id

      The identifier of a nonce: if absent, it will set the nonce used for requests to Auth0. Otherwise, it will be used to select a specific non-Auth0 nonce.

      Advanced

    class AuthenticationError

    class AuthenticationError extends GenericError {}
    • Thrown when handling the redirect callback fails, will be one of Auth0's Authentication API's Standard Error Responses: https://auth0.com/docs/api/authentication?javascript#standard-error-responses

      Errors

    constructor

    constructor(
    error: string,
    error_description: string,
    state: string,
    appState?: any
    );

      property appState

      appState: any;

        property state

        state: string;

          class CacheKey

          class CacheKey {}

            constructor

            constructor(data: CacheKeyData, prefix?: string, suffix?: string);

              property audience

              audience?: string;

                property clientId

                clientId: string;

                  property prefix

                  prefix: string;

                    property scope

                    scope?: string;

                      property suffix

                      suffix?: string;

                        method fromCacheEntry

                        static fromCacheEntry: (entry: CacheEntry) => CacheKey;
                        • Utility function to build a CacheKey instance from a cache entry

                          Parameter entry

                          The entry

                          Returns

                          An instance of CacheKey

                        method fromKey

                        static fromKey: (key: string) => CacheKey;
                        • Converts a cache key string into a CacheKey instance.

                          Parameter key

                          The key to convert

                          Returns

                          An instance of CacheKey

                        method toKey

                        toKey: () => string;
                        • Converts this CacheKey instance into a string for use in a cache

                          Returns

                          A string representation of the key

                        class ConnectError

                        class ConnectError extends GenericError {}
                        • Thrown when handling the redirect callback for the connect flow fails, will be one of Auth0's Authentication API's Standard Error Responses: https://auth0.com/docs/api/authentication?javascript#standard-error-responses

                          Errors

                        constructor

                        constructor(
                        error: string,
                        error_description: string,
                        connection: string,
                        state: string,
                        appState?: any
                        );

                          property appState

                          appState: any;

                            property connection

                            connection: string;

                              property state

                              state: string;

                                class Fetcher

                                class Fetcher<TOutput extends CustomFetchMinimalOutput> {}
                                • Calls your APIs with an Auth0 access token attached automatically.

                                  Clients

                                constructor

                                constructor(config: FetcherConfig<TOutput>, hooks: FetcherHooks);

                                  property config

                                  protected readonly config: Omit<FetcherConfig<TOutput>, 'fetch'> &
                                  Required<Pick<FetcherConfig<TOutput>, 'fetch'>>;

                                    property hooks

                                    protected readonly hooks: FetcherHooks;

                                      method buildBaseRequest

                                      protected buildBaseRequest: (
                                      info: RequestInfo | URL,
                                      init: RequestInit | undefined
                                      ) => Request;

                                        method buildUrl

                                        protected buildUrl: (
                                        baseUrl: string | undefined,
                                        url: string | undefined
                                        ) => string;

                                          method extractUrl

                                          protected extractUrl: (info: RequestInfo | URL) => string;

                                            method fetchWithAuth

                                            fetchWithAuth: (
                                            info: RequestInfo | URL,
                                            init?: RequestInit,
                                            authParams?: AuthParams
                                            ) => Promise<TOutput>;

                                              method getAccessToken

                                              protected getAccessToken: (
                                              authParams?: AuthParams
                                              ) => Promise<string | GetTokenSilentlyVerboseResponse | undefined>;

                                                method getHeader

                                                protected getHeader: (headers: ResponseHeaders, name: string) => string;

                                                  method handleResponse

                                                  protected handleResponse: (
                                                  response: TOutput,
                                                  callbacks: FetchWithAuthCallbacks<TOutput>
                                                  ) => Promise<TOutput>;

                                                    method hasUseDpopNonceError

                                                    protected hasUseDpopNonceError: (response: TOutput) => boolean;

                                                      method internalFetchWithAuth

                                                      protected internalFetchWithAuth: (
                                                      info: RequestInfo | URL,
                                                      init: RequestInit | undefined,
                                                      callbacks: FetchWithAuthCallbacks<TOutput>,
                                                      authParams?: AuthParams
                                                      ) => Promise<TOutput>;

                                                        method isAbsoluteUrl

                                                        protected isAbsoluteUrl: (url: string) => boolean;

                                                          method prepareRequest

                                                          protected prepareRequest: (
                                                          request: Request,
                                                          authParams?: AuthParams
                                                          ) => Promise<void>;

                                                            method setAuthorizationHeader

                                                            protected setAuthorizationHeader: (
                                                            request: Request,
                                                            accessToken: string,
                                                            tokenType?: string
                                                            ) => void;

                                                              method setDpopProofHeader

                                                              protected setDpopProofHeader: (
                                                              request: Request,
                                                              accessToken: string
                                                              ) => Promise<void>;

                                                                class GenericError

                                                                class GenericError extends Error {}
                                                                • Thrown when network requests to the Auth server fail.

                                                                  Errors

                                                                constructor

                                                                constructor(
                                                                error: string,
                                                                error_description: string,
                                                                data?: Record<string, any>
                                                                );
                                                                • Parameter error

                                                                  The error code from the server response.

                                                                  Parameter error_description

                                                                  The error_description from the server response.

                                                                  Parameter data

                                                                  Any other fields from the server's error response (for example auth_session).

                                                                property data

                                                                data?: Record<string, any>;

                                                                  property error

                                                                  error: string;

                                                                    property error_description

                                                                    error_description: string;

                                                                      method fromPayload

                                                                      static fromPayload: ({
                                                                      error,
                                                                      error_description,
                                                                      }: {
                                                                      error: string;
                                                                      error_description: string;
                                                                      }) => GenericError;

                                                                        class InMemoryCache

                                                                        class InMemoryCache {}

                                                                          property enclosedCache

                                                                          enclosedCache: ICache;

                                                                            class InvalidConfigurationError

                                                                            class InvalidConfigurationError extends GenericError {}
                                                                            • Thrown at construction time for an invalid option combination (e.g. refreshTokenMode: 'online' without useDpop: true). The suggestion names the fix.

                                                                              Errors

                                                                            constructor

                                                                            constructor(message: string, suggestion: string);

                                                                              property suggestion

                                                                              suggestion: string;

                                                                                class LocalStorageCache

                                                                                class LocalStorageCache implements ICache {}

                                                                                  method allKeys

                                                                                  allKeys: () => string[];

                                                                                    method get

                                                                                    get: <T = Cacheable>(key: string) => MaybePromise<T | undefined>;

                                                                                      method remove

                                                                                      remove: (key: string) => void;

                                                                                        method set

                                                                                        set: <T = Cacheable>(key: string, entry: T) => void;

                                                                                          class MfaApiClient

                                                                                          class MfaApiClient {}
                                                                                          • Client for Auth0 MFA API operations

                                                                                            Manages multi-factor authentication including: - Listing enrolled authenticators - Enrolling new authenticators (OTP, SMS, Voice, Push, Email) - Initiating MFA challenges - Verifying MFA challenges

                                                                                            This is a wrapper around auth0-auth-js MfaClient that maintains backward compatibility with the existing spa-js API.

                                                                                            MFA context (scope, audience) is stored internally keyed by mfaToken, enabling concurrent MFA flows without state conflicts.

                                                                                            Example 1

                                                                                            try {
                                                                                            await auth0.getTokenSilently({ authorizationParams: { audience: 'https://api.example.com' } });
                                                                                            } catch (e) {
                                                                                            if (e instanceof MfaRequiredError) {
                                                                                            // SDK automatically stores context for this mfaToken
                                                                                            const authenticators = await auth0.mfa.getAuthenticators({ mfaToken: e.mfa_token });
                                                                                            // ... complete MFA flow
                                                                                            }
                                                                                            }

                                                                                            Clients

                                                                                          method challenge

                                                                                          challenge: (params: ChallengeAuthenticatorParams) => Promise<ChallengeResponse>;
                                                                                          • Initiates an MFA challenge

                                                                                            Sends OTP via SMS, initiates push notification, or prepares for OTP entry

                                                                                            Parameter params

                                                                                            Challenge parameters including mfaToken

                                                                                            Returns

                                                                                            Challenge response with oobCode if applicable

                                                                                            Throws

                                                                                            {MfaChallengeError} If challenge initiation fails

                                                                                            Example 1

                                                                                            OTP challenge

                                                                                            const challenge = await mfa.challenge({
                                                                                            mfaToken: mfaTokenFromLogin,
                                                                                            challengeType: 'otp',
                                                                                            authenticatorId: 'otp|dev_xxx'
                                                                                            });
                                                                                            // User enters OTP from their authenticator app

                                                                                            Example 2

                                                                                            SMS challenge

                                                                                            const challenge = await mfa.challenge({
                                                                                            mfaToken: mfaTokenFromLogin,
                                                                                            challengeType: 'oob',
                                                                                            authenticatorId: 'sms|dev_xxx'
                                                                                            });
                                                                                            console.log(challenge.oobCode); // Use for verification

                                                                                          method enroll

                                                                                          enroll: (params: EnrollParams) => Promise<EnrollmentResponse>;
                                                                                          • Enrolls a new MFA authenticator

                                                                                            Requires MFA access token with 'enroll' scope

                                                                                            Parameter params

                                                                                            Enrollment parameters including mfaToken and factorType

                                                                                            Returns

                                                                                            Enrollment response with authenticator details

                                                                                            Throws

                                                                                            {MfaEnrollmentError} If enrollment fails

                                                                                            Example 1

                                                                                            OTP enrollment

                                                                                            const enrollment = await mfa.enroll({
                                                                                            mfaToken: mfaToken,
                                                                                            factorType: 'otp'
                                                                                            });
                                                                                            console.log(enrollment.secret); // Base32 secret
                                                                                            console.log(enrollment.barcodeUri); // QR code URI

                                                                                            Example 2

                                                                                            SMS enrollment

                                                                                            const enrollment = await mfa.enroll({
                                                                                            mfaToken: mfaToken,
                                                                                            factorType: 'sms',
                                                                                            phoneNumber: '+12025551234'
                                                                                            });

                                                                                          method getAuthenticators

                                                                                          getAuthenticators: (mfaToken: string) => Promise<Authenticator[]>;
                                                                                          • Gets enrolled MFA authenticators filtered by challenge types from context.

                                                                                            Challenge types are automatically resolved from the stored MFA context (set when mfa_required error occurred).

                                                                                            Parameter mfaToken

                                                                                            MFA token from mfa_required error

                                                                                            Returns

                                                                                            Array of enrolled authenticators matching the challenge types

                                                                                            Throws

                                                                                            {MfaListAuthenticatorsError} If the request fails or context not found

                                                                                            Example 1

                                                                                            Basic usage

                                                                                            try {
                                                                                            await auth0.getTokenSilently();
                                                                                            } catch (e) {
                                                                                            if (e instanceof MfaRequiredError) {
                                                                                            // SDK automatically uses challenge types from error context
                                                                                            const authenticators = await auth0.mfa.getAuthenticators(e.mfa_token);
                                                                                            }
                                                                                            }

                                                                                          method getEnrollmentFactors

                                                                                          getEnrollmentFactors: (mfaToken: string) => Promise<EnrollmentFactor[]>;
                                                                                          • Gets available MFA enrollment factors from the stored context.

                                                                                            This method exposes the enrollment options from the mfa_required error's mfaRequirements.enroll array, eliminating the need for manual parsing.

                                                                                            Parameter mfaToken

                                                                                            MFA token from mfa_required error

                                                                                            Returns

                                                                                            Array of enrollment factors available for the user (empty array if no enrollment required)

                                                                                            Throws

                                                                                            {MfaEnrollmentFactorsError} If MFA context not found

                                                                                            Example 1

                                                                                            Basic usage

                                                                                            try {
                                                                                            await auth0.getTokenSilently();
                                                                                            } catch (error) {
                                                                                            if (error.error === 'mfa_required') {
                                                                                            // Get enrollment options from SDK
                                                                                            const enrollOptions = await auth0.mfa.getEnrollmentFactors(error.mfa_token);
                                                                                            // [{ type: 'otp' }, { type: 'phone' }, { type: 'push-notification' }]
                                                                                            showEnrollmentOptions(enrollOptions);
                                                                                            }
                                                                                            }

                                                                                            Example 2

                                                                                            Check if enrollment is required

                                                                                            try {
                                                                                            const factors = await auth0.mfa.getEnrollmentFactors(mfaToken);
                                                                                            if (factors.length > 0) {
                                                                                            // User needs to enroll in MFA
                                                                                            renderEnrollmentUI(factors);
                                                                                            } else {
                                                                                            // No enrollment required, proceed with challenge
                                                                                            }
                                                                                            } catch (error) {
                                                                                            if (error instanceof MfaEnrollmentFactorsError) {
                                                                                            console.error('Context not found:', error.error_description);
                                                                                            }
                                                                                            }

                                                                                          method verify

                                                                                          verify: (params: VerifyParams) => Promise<TokenEndpointResponse>;
                                                                                          • Verifies an MFA challenge and completes authentication

                                                                                            The scope and audience are retrieved from the stored context (set when the mfa_required error occurred). The grant_type is automatically inferred from which verification field is provided (otp, oobCode, or recoveryCode).

                                                                                            Parameter params

                                                                                            Verification parameters with OTP, OOB code, or recovery code

                                                                                            Returns

                                                                                            Token response with access_token, id_token, refresh_token

                                                                                            Throws

                                                                                            {MfaVerifyError} If verification fails (invalid code, expired, rate limited)

                                                                                            Throws

                                                                                            {MfaVerifyError} If MFA context not found

                                                                                            Throws

                                                                                            {MfaVerifyError} If grant_type cannot be inferred

                                                                                            Rate limits: - 10 verification attempts allowed - Refreshes at 1 attempt per 6 minutes

                                                                                            Example 1

                                                                                            OTP verification (grant_type inferred from otp field)

                                                                                            const tokens = await mfa.verify({
                                                                                            mfaToken: mfaTokenFromLogin,
                                                                                            otp: '123456'
                                                                                            });
                                                                                            console.log(tokens.access_token);

                                                                                            Example 2

                                                                                            OOB verification (grant_type inferred from oobCode field)

                                                                                            const tokens = await mfa.verify({
                                                                                            mfaToken: mfaTokenFromLogin,
                                                                                            oobCode: challenge.oobCode,
                                                                                            bindingCode: '123456' // Code user received via SMS
                                                                                            });

                                                                                            Example 3

                                                                                            Recovery code verification (grant_type inferred from recoveryCode field)

                                                                                            const tokens = await mfa.verify({
                                                                                            mfaToken: mfaTokenFromLogin,
                                                                                            recoveryCode: 'XXXX-XXXX-XXXX'
                                                                                            });

                                                                                          class MfaChallengeError

                                                                                          class MfaChallengeError extends MfaError {}
                                                                                          • Error thrown when initiating an MFA challenge fails.

                                                                                            Example 1

                                                                                            try {
                                                                                            const challenge = await mfa.challenge({
                                                                                            mfaToken: mfaToken,
                                                                                            challengeType: 'otp',
                                                                                            authenticatorId: 'otp|dev_123'
                                                                                            });
                                                                                            } catch (error) {
                                                                                            if (error instanceof MfaChallengeError) {
                                                                                            console.log(error.error); // 'too_many_attempts'
                                                                                            console.log(error.error_description); // 'Rate limit exceeded'
                                                                                            }
                                                                                            }

                                                                                          constructor

                                                                                          constructor(error: string, error_description: string);

                                                                                            class MfaEnrollmentError

                                                                                            class MfaEnrollmentError extends MfaError {}
                                                                                            • Error thrown when enrolling an MFA authenticator fails.

                                                                                              Example 1

                                                                                              try {
                                                                                              const enrollment = await mfa.enroll({
                                                                                              authenticator_types: ['otp']
                                                                                              });
                                                                                              } catch (error) {
                                                                                              if (error instanceof MfaEnrollmentError) {
                                                                                              console.log(error.error); // 'invalid_phone_number'
                                                                                              console.log(error.error_description); // 'Invalid phone number format'
                                                                                              }
                                                                                              }

                                                                                            constructor

                                                                                            constructor(error: string, error_description: string);

                                                                                              class MfaEnrollmentFactorsError

                                                                                              class MfaEnrollmentFactorsError extends MfaError {}
                                                                                              • Error thrown when getting enrollment factors fails.

                                                                                                Example 1

                                                                                                try {
                                                                                                const factors = await mfa.getEnrollmentFactors(mfaToken);
                                                                                                } catch (error) {
                                                                                                if (error instanceof MfaEnrollmentFactorsError) {
                                                                                                console.log(error.error); // 'mfa_context_not_found'
                                                                                                console.log(error.error_description); // 'MFA context not found...'
                                                                                                }
                                                                                                }

                                                                                              constructor

                                                                                              constructor(error: string, error_description: string);

                                                                                                class MfaError

                                                                                                class MfaError extends GenericError {}
                                                                                                • Base class for MFA-related errors in auth0-spa-js. Extends GenericError for unified error hierarchy across the SDK.

                                                                                                constructor

                                                                                                constructor(error: string, error_description: string);

                                                                                                  method fromPayload

                                                                                                  static fromPayload: ({
                                                                                                  error,
                                                                                                  error_description,
                                                                                                  }: {
                                                                                                  error: string;
                                                                                                  error_description: string;
                                                                                                  }) => MfaError;

                                                                                                    class MfaListAuthenticatorsError

                                                                                                    class MfaListAuthenticatorsError extends MfaError {}
                                                                                                    • Error thrown when listing MFA authenticators fails.

                                                                                                      Example 1

                                                                                                      try {
                                                                                                      const authenticators = await mfa.getAuthenticators();
                                                                                                      } catch (error) {
                                                                                                      if (error instanceof MfaListAuthenticatorsError) {
                                                                                                      console.log(error.error); // 'access_denied'
                                                                                                      console.log(error.error_description); // 'Unauthorized'
                                                                                                      }
                                                                                                      }

                                                                                                    constructor

                                                                                                    constructor(error: string, error_description: string);

                                                                                                      class MfaRequiredError

                                                                                                      class MfaRequiredError extends GenericError {}
                                                                                                      • Error thrown when the token exchange results in a mfa_required error

                                                                                                        Errors

                                                                                                      constructor

                                                                                                      constructor(
                                                                                                      error: string,
                                                                                                      error_description: string,
                                                                                                      mfa_token: string,
                                                                                                      mfa_requirements: MfaRequirements
                                                                                                      );

                                                                                                        property mfa_requirements

                                                                                                        mfa_requirements: MfaRequirements;

                                                                                                          property mfa_token

                                                                                                          mfa_token: string;

                                                                                                            class MfaVerifyError

                                                                                                            class MfaVerifyError extends MfaError {}
                                                                                                            • Error thrown when verifying an MFA challenge fails.

                                                                                                              Example 1

                                                                                                              try {
                                                                                                              const tokens = await mfa.verify({
                                                                                                              mfaToken: mfaToken,
                                                                                                              grant_type: 'http://auth0.com/oauth/grant-type/mfa-otp',
                                                                                                              otp: '123456'
                                                                                                              });
                                                                                                              } catch (error) {
                                                                                                              if (error instanceof MfaVerifyError) {
                                                                                                              console.log(error.error); // 'invalid_otp' or 'context_not_found'
                                                                                                              console.log(error.error_description); // Error details
                                                                                                              }
                                                                                                              }

                                                                                                            constructor

                                                                                                            constructor(error: string, error_description: string);

                                                                                                              class MissingRefreshTokenError

                                                                                                              class MissingRefreshTokenError extends GenericError {}
                                                                                                              • Error thrown when there is no refresh token to use

                                                                                                                Errors

                                                                                                              constructor

                                                                                                              constructor(audience: string, scope: string);

                                                                                                                property audience

                                                                                                                audience: string;

                                                                                                                  property scope

                                                                                                                  scope: string;

                                                                                                                    class MissingScopesError

                                                                                                                    class MissingScopesError extends GenericError {}
                                                                                                                    • Error thrown when there are missing scopes after refreshing a token

                                                                                                                      Errors

                                                                                                                    constructor

                                                                                                                    constructor(audience: string, scope: string);

                                                                                                                      property audience

                                                                                                                      audience: string;

                                                                                                                        property scope

                                                                                                                        scope: string;

                                                                                                                          class MyAccountApiClient

                                                                                                                          class MyAccountApiClient {}
                                                                                                                          • Client for Auth0 MyAccount API operations.

                                                                                                                            Provides methods for managing the current user's account: - Connected accounts (link/unlink external identity providers) - MFA factors - Authentication methods (passkeys, phone, email, TOTP) - list, get, update, delete - Authentication method enrollment (challenge and verify)

                                                                                                                            Clients

                                                                                                                          constructor

                                                                                                                          constructor(myAccountFetcher: Fetcher<Response>, apiBase: string);

                                                                                                                            method completeAccount

                                                                                                                            completeAccount: (params: CompleteRequest) => Promise<CompleteResponse>;
                                                                                                                            • Verify the redirect from the connect account flow and complete the connecting of the account.

                                                                                                                              Parameter params

                                                                                                                              Completion parameters including auth session, connect code, and redirect URI

                                                                                                                              Returns

                                                                                                                              A promise that resolves to the completed connected account details

                                                                                                                            method connectAccount

                                                                                                                            connectAccount: (params: ConnectRequest) => Promise<ConnectResponse>;
                                                                                                                            • Get a ticket for the connect account flow.

                                                                                                                              Parameter params

                                                                                                                              Connection parameters including connection name and redirect URI

                                                                                                                              Returns

                                                                                                                              A promise that resolves to a connect response with the redirect URI and auth session

                                                                                                                            method deleteAuthenticationMethod

                                                                                                                            deleteAuthenticationMethod: (id: string) => Promise<void>;
                                                                                                                            • Delete an authentication method by ID.

                                                                                                                              Parameter id

                                                                                                                              The ID of the authentication method to delete

                                                                                                                              Returns

                                                                                                                              A promise that resolves when the authentication method has been deleted

                                                                                                                            method enrollmentChallenge

                                                                                                                            enrollmentChallenge: (
                                                                                                                            options: EnrollmentChallengeOptions
                                                                                                                            ) => Promise<EnrollmentChallengeResponse>;
                                                                                                                            • Start the enrollment of an authentication method for the current user. The response shape varies by type.

                                                                                                                              Parameter options

                                                                                                                              Enrollment challenge options specifying the factor type and any type-specific fields

                                                                                                                              Returns

                                                                                                                              A promise that resolves to the enrollment challenge response (shape varies by type)

                                                                                                                            method enrollmentVerify

                                                                                                                            enrollmentVerify: (
                                                                                                                            options: EnrollmentVerifyOptions
                                                                                                                            ) => Promise<AuthenticationMethod>;
                                                                                                                            • Confirm the enrollment of an authentication method to complete registration.

                                                                                                                              Parameter options

                                                                                                                              Enrollment verify options including the auth session and type-specific verification data

                                                                                                                              Returns

                                                                                                                              A promise that resolves to the confirmed authentication method

                                                                                                                            method getAuthenticationMethod

                                                                                                                            getAuthenticationMethod: (id: string) => Promise<AuthenticationMethod>;
                                                                                                                            • Get an authentication method by ID.

                                                                                                                              Parameter id

                                                                                                                              The ID of the authentication method to retrieve

                                                                                                                              Returns

                                                                                                                              A promise that resolves to the authentication method

                                                                                                                            method getAuthenticationMethods

                                                                                                                            getAuthenticationMethods: (
                                                                                                                            type?: AuthenticationMethodType
                                                                                                                            ) => Promise<AuthenticationMethod[]>;
                                                                                                                            • Get a list of all authentication methods for the current user.

                                                                                                                              Parameter type

                                                                                                                              Optional filter to return only methods of a specific type

                                                                                                                              Returns

                                                                                                                              A promise that resolves to an array of authentication methods

                                                                                                                            method getFactors

                                                                                                                            getFactors: () => Promise<Factor[]>;
                                                                                                                            • Get the status of all factors for the current user.

                                                                                                                              Returns

                                                                                                                              A promise that resolves to an array of factors with their enabled/disabled status

                                                                                                                            method getUserProfile

                                                                                                                            getUserProfile: (options?: GetUserProfileOptions) => Promise<UserProfile>;
                                                                                                                            • Get the current user's profile, including profile_policy with per-field edit permissions.

                                                                                                                              Parameter options

                                                                                                                              Optional fields to return, or set includeFields: false to exclude them instead

                                                                                                                              Returns

                                                                                                                              A promise that resolves to the user's profile

                                                                                                                            method updateAuthenticationMethod

                                                                                                                            updateAuthenticationMethod: (
                                                                                                                            id: string,
                                                                                                                            data: UpdateAuthenticationMethodRequest
                                                                                                                            ) => Promise<AuthenticationMethod>;
                                                                                                                            • Update details of an authentication method by ID.

                                                                                                                              Parameter id

                                                                                                                              The ID of the authentication method to update

                                                                                                                              Parameter data

                                                                                                                              The fields to update (e.g. name, preferred_authentication_method for phone)

                                                                                                                              Returns

                                                                                                                              A promise that resolves to the updated authentication method

                                                                                                                            method updateUserProfile

                                                                                                                            updateUserProfile: (data: UpdateUserProfileRequest) => Promise<UserProfile>;
                                                                                                                            • Update the current user's profile. Only the fields you send are changed.

                                                                                                                              Parameter data

                                                                                                                              The profile fields to update

                                                                                                                              Returns

                                                                                                                              A promise that resolves to the full updated profile

                                                                                                                            class MyAccountApiError

                                                                                                                            class MyAccountApiError extends Error {}
                                                                                                                            • Error thrown when the MyAccount API returns a non-2xx response.

                                                                                                                              Example 1

                                                                                                                              try {
                                                                                                                              await myAccount.getAuthenticationMethods();
                                                                                                                              } catch (err) {
                                                                                                                              if (err instanceof MyAccountApiError) {
                                                                                                                              console.error(err.status, err.title, err.detail);
                                                                                                                              }
                                                                                                                              }

                                                                                                                            constructor

                                                                                                                            constructor({ type, status, title, detail, validation_errors }: ErrorResponse);

                                                                                                                              property detail

                                                                                                                              readonly detail: string;
                                                                                                                              • Human-readable explanation specific to this occurrence

                                                                                                                              property status

                                                                                                                              readonly status: number;
                                                                                                                              • HTTP status code

                                                                                                                              property title

                                                                                                                              readonly title: string;
                                                                                                                              • Short human-readable summary of the error

                                                                                                                              property type

                                                                                                                              readonly type: string;
                                                                                                                              • RFC 7807 error type identifier

                                                                                                                              property validation_errors

                                                                                                                              readonly validation_errors?: {
                                                                                                                              detail: string;
                                                                                                                              field?: string;
                                                                                                                              pointer?: string;
                                                                                                                              source?: string;
                                                                                                                              }[];
                                                                                                                              • Field-level validation errors, if present

                                                                                                                              class PasskeyApiClient

                                                                                                                              class PasskeyApiClient {}
                                                                                                                              • Client for Auth0 Passkey operations.

                                                                                                                                Provides 2 public methods: - signup — Register a new user with a passkey (full flow: challenge → WebAuthn → token exchange) - login — Sign in with a passkey (full flow: challenge → WebAuthn → token exchange)

                                                                                                                                Example 1

                                                                                                                                // Signup — single call handles everything
                                                                                                                                const tokens = await auth0.passkey.signup({ email: 'user@example.com' });
                                                                                                                                // Login — single call handles everything
                                                                                                                                const tokens = await auth0.passkey.login();

                                                                                                                                Clients

                                                                                                                              method continueSignup

                                                                                                                              continueSignup: (verification: {
                                                                                                                              email?: string;
                                                                                                                              phone?: string;
                                                                                                                              }) => Promise<TokenEndpointResponse>;
                                                                                                                              • Continue a signup that was interrupted by identifier verification.

                                                                                                                                Call this after catching PasskeyVerificationRequiredError from signup(), collecting OTP codes from the user, and passing them here. The SDK internally retains the auth session — you do not need to pass it.

                                                                                                                                If the codes are wrong but the session is still alive, this throws a PasskeyGetTokenError with isRetryable: true. Collect new codes for error.verificationRequired and call continueSignup() again; the same passkey is reused, so the user is not prompted again.

                                                                                                                                Parameter verification

                                                                                                                                Map of identifier → OTP code (e.g. { phone: "123456" })

                                                                                                                                Returns

                                                                                                                                A promise resolving to the token endpoint response

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If there is no pending signup (signup() was not called first)

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If a code is missing for a required identifier. The pending signup is kept

                                                                                                                                Throws

                                                                                                                                {PasskeyGetTokenError} If an OTP code is wrong and the session is still active (isRetryable: true)

                                                                                                                                Throws

                                                                                                                                {GenericError} If the token exchange fails

                                                                                                                              method getLoginChallenge

                                                                                                                              getLoginChallenge: (
                                                                                                                              options?: PasskeyLoginChallengeOptions
                                                                                                                              ) => Promise<PasskeyLoginChallenge>;
                                                                                                                              • Request a passkey login challenge.

                                                                                                                                Step 1 of the granular login flow. Returns the auth session and a decoded PublicKeyCredentialRequestOptions. Run the WebAuthn assertion ceremony with publicKey, then hand the resulting credential and authSession to getTokenWithPasskey().

                                                                                                                                Parameter options

                                                                                                                                Optional login challenge options (realm/organization)

                                                                                                                                Returns

                                                                                                                                A promise resolving to { authSession, publicKey }

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If WebAuthn is not supported in the browser

                                                                                                                                Throws

                                                                                                                                {PasskeyChallengeError} If the challenge request fails

                                                                                                                              method getSignupChallenge

                                                                                                                              getSignupChallenge: (
                                                                                                                              options: PasskeySignupChallengeOptions
                                                                                                                              ) => Promise<PasskeySignupChallenge>;
                                                                                                                              • Request a passkey signup challenge.

                                                                                                                                Step 1 of the granular signup flow. Returns the auth session and a decoded PublicKeyCredentialCreationOptions. Run the WebAuthn credential creation ceremony with publicKey, then hand the resulting credential and authSession to getTokenWithPasskey().

                                                                                                                                Parameter options

                                                                                                                                Signup challenge options (user identifier, optional realm/organization/metadata)

                                                                                                                                Returns

                                                                                                                                A promise resolving to { authSession, publicKey }

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If WebAuthn is not supported in the browser

                                                                                                                                Throws

                                                                                                                                {PasskeyRegisterError} If the challenge request fails

                                                                                                                              method getTokenWithPasskey

                                                                                                                              getTokenWithPasskey: (
                                                                                                                              options: PasskeyGetTokenOptions
                                                                                                                              ) => Promise<TokenEndpointResponse>;
                                                                                                                              • Exchange a signed passkey credential for tokens.

                                                                                                                                Step 2 of the granular flow. Serializes the raw PublicKeyCredential produced by the WebAuthn ceremony — either a creation (signup) or an assertion (login) credential — and exchanges it for tokens. The credential type (attestation vs assertion) is detected automatically.

                                                                                                                                Parameter options

                                                                                                                                The auth session, raw credential, and optional realm/organization/scope/audience

                                                                                                                                Returns

                                                                                                                                A promise resolving to the token endpoint response

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If WebAuthn is not supported in the browser

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If the credential is not a valid attestation or assertion response

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If a code in verification is empty. Nothing is sent, so the same session can be retried

                                                                                                                                Throws

                                                                                                                                {PasskeyGetTokenError} If an OTP code is wrong and the session is still active (isRetryable: true)

                                                                                                                                Throws

                                                                                                                                {GenericError} If the token exchange fails

                                                                                                                              method login

                                                                                                                              login: (options?: PasskeyLoginOptions) => Promise<TokenEndpointResponse>;
                                                                                                                              • Sign in with an existing passkey.

                                                                                                                                Handles the full flow: requests a login challenge, triggers the browser WebAuthn assertion ceremony, serializes the result, and exchanges it for tokens.

                                                                                                                                Parameter options

                                                                                                                                Optional passkey login options (optional scope/audience/realm/organization)

                                                                                                                                Returns

                                                                                                                                A promise that resolves to the token endpoint response containing access/ID tokens

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If WebAuthn is not supported in the browser

                                                                                                                                Throws

                                                                                                                                {PasskeyChallengeError} If the challenge request fails

                                                                                                                                Throws

                                                                                                                                {GenericError} If the token exchange fails

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If the user cancels the WebAuthn prompt

                                                                                                                              method signup

                                                                                                                              signup: (options: PasskeySignupOptions) => Promise<TokenEndpointResponse>;
                                                                                                                              • Register a new user with a passkey.

                                                                                                                                Handles the full flow: requests a signup challenge, triggers the browser WebAuthn credential creation ceremony, serializes the result, and exchanges it for tokens.

                                                                                                                                If the server requires identifier verification, it stops before creating the passkey and throws PasskeyVerificationRequiredError. Collect the OTP codes and call continueSignup() to finish.

                                                                                                                                Parameter options

                                                                                                                                Passkey signup options (user identifier, optional scope/audience)

                                                                                                                                Returns

                                                                                                                                A promise that resolves to the token endpoint response containing access/ID tokens

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If WebAuthn is not supported in the browser

                                                                                                                                Throws

                                                                                                                                {PasskeyRegisterError} If the challenge request fails

                                                                                                                                Throws

                                                                                                                                {PasskeyVerificationRequiredError} If OTP codes are needed before the passkey is created

                                                                                                                                Throws

                                                                                                                                {GenericError} If the token exchange fails

                                                                                                                                Throws

                                                                                                                                {PasskeyError} If the user cancels the WebAuthn prompt

                                                                                                                              class PasskeyError

                                                                                                                              class PasskeyError extends Error {}

                                                                                                                                constructor

                                                                                                                                constructor(code: string, message: string, cause?: PasskeyErrorResponse);

                                                                                                                                  property cause

                                                                                                                                  readonly cause?: PasskeyErrorResponse;

                                                                                                                                    property code

                                                                                                                                    readonly code: string;

                                                                                                                                      class PasskeyVerificationRequiredError

                                                                                                                                      class PasskeyVerificationRequiredError extends GenericError {}
                                                                                                                                      • Thrown by signup() when the server requires identifier verification before passkey creation. Catch this error, collect OTP codes for each identifier in verificationRequired, then call passkey.continueSignup(codes) to complete the flow. The SDK retains the auth session internally — you do not need to pass it yourself.

                                                                                                                                        Errors

                                                                                                                                      constructor

                                                                                                                                      constructor(verificationRequired: ('email' | 'phone')[]);

                                                                                                                                        property verificationRequired

                                                                                                                                        readonly verificationRequired: ('email' | 'phone')[];

                                                                                                                                          class PopupCancelledError

                                                                                                                                          class PopupCancelledError extends GenericError {}
                                                                                                                                          • Error thrown when the login popup is closed before auth completes.

                                                                                                                                            Errors

                                                                                                                                          constructor

                                                                                                                                          constructor(popup: Window);

                                                                                                                                            property popup

                                                                                                                                            popup: Window;

                                                                                                                                              class PopupOpenError

                                                                                                                                              class PopupOpenError extends GenericError {}
                                                                                                                                              • Error thrown when a popup cannot be opened (window.open returned null).

                                                                                                                                                Errors

                                                                                                                                              constructor

                                                                                                                                              constructor();

                                                                                                                                                class PopupTimeoutError

                                                                                                                                                class PopupTimeoutError extends TimeoutError {}
                                                                                                                                                • Error thrown when the login popup times out (if the user does not complete auth)

                                                                                                                                                  Errors

                                                                                                                                                constructor

                                                                                                                                                constructor(popup: Window);

                                                                                                                                                  property popup

                                                                                                                                                  popup: Window;

                                                                                                                                                    class TimeoutError

                                                                                                                                                    class TimeoutError extends GenericError {}
                                                                                                                                                    • Thrown when silent auth times out (usually due to a configuration issue) or when network requests to the Auth server timeout.

                                                                                                                                                      Errors

                                                                                                                                                    constructor

                                                                                                                                                    constructor();

                                                                                                                                                      class UseDpopNonceError

                                                                                                                                                      class UseDpopNonceError extends GenericError {}
                                                                                                                                                      • Error thrown when the wrong DPoP nonce is used and a potential subsequent retry wasn't able to fix it.

                                                                                                                                                        Errors

                                                                                                                                                      constructor

                                                                                                                                                      constructor(newDpopNonce: string);

                                                                                                                                                        property newDpopNonce

                                                                                                                                                        newDpopNonce: string;

                                                                                                                                                          class User

                                                                                                                                                          class User {}
                                                                                                                                                          • Tokens & Users

                                                                                                                                                          property act

                                                                                                                                                          act?: ActClaim;

                                                                                                                                                            property address

                                                                                                                                                            address?: string;

                                                                                                                                                              property birthdate

                                                                                                                                                              birthdate?: string;

                                                                                                                                                                property email

                                                                                                                                                                email?: string;

                                                                                                                                                                  property email_verified

                                                                                                                                                                  email_verified?: boolean;

                                                                                                                                                                    property family_name

                                                                                                                                                                    family_name?: string;

                                                                                                                                                                      property gender

                                                                                                                                                                      gender?: string;

                                                                                                                                                                        property given_name

                                                                                                                                                                        given_name?: string;

                                                                                                                                                                          property locale

                                                                                                                                                                          locale?: string;

                                                                                                                                                                            property middle_name

                                                                                                                                                                            middle_name?: string;

                                                                                                                                                                              property name

                                                                                                                                                                              name?: string;

                                                                                                                                                                                property nickname

                                                                                                                                                                                nickname?: string;

                                                                                                                                                                                  property phone_number

                                                                                                                                                                                  phone_number?: string;

                                                                                                                                                                                    property phone_number_verified

                                                                                                                                                                                    phone_number_verified?: boolean;

                                                                                                                                                                                      property picture

                                                                                                                                                                                      picture?: string;

                                                                                                                                                                                        property preferred_username

                                                                                                                                                                                        preferred_username?: string;

                                                                                                                                                                                          property profile

                                                                                                                                                                                          profile?: string;

                                                                                                                                                                                            property sub

                                                                                                                                                                                            sub?: string;

                                                                                                                                                                                              property updated_at

                                                                                                                                                                                              updated_at?: string;

                                                                                                                                                                                                property website

                                                                                                                                                                                                website?: string;

                                                                                                                                                                                                  property zoneinfo

                                                                                                                                                                                                  zoneinfo?: string;

                                                                                                                                                                                                    Interfaces

                                                                                                                                                                                                    interface ActClaim

                                                                                                                                                                                                    interface ActClaim {}
                                                                                                                                                                                                    • Represents the actor claim (act) in an ID token returned via a token exchange response.

                                                                                                                                                                                                      The act claim identifies the acting party — the entity that has been delegated authority to act on behalf of the subject. It is set via Auth0 Actions using the setActor command.

                                                                                                                                                                                                      See Also

                                                                                                                                                                                                    property sub

                                                                                                                                                                                                    sub?: string;
                                                                                                                                                                                                    • The identifier of the acting party.

                                                                                                                                                                                                    index signature

                                                                                                                                                                                                    [key: string]: any;

                                                                                                                                                                                                      interface Auth0ClientOptions

                                                                                                                                                                                                      interface Auth0ClientOptions {}
                                                                                                                                                                                                      • Configuration

                                                                                                                                                                                                      property anonymousSessionsCacheMode

                                                                                                                                                                                                      anonymousSessionsCacheMode?: 'localStorage' | 'memory';
                                                                                                                                                                                                      • Where to store the anonymous session token.

                                                                                                                                                                                                        - 'localStorage' (default): the session token survives page reloads. Suitable for most SPAs. - 'memory': the session token lives only for the current page load. Use this if you do not want anonymous session data written to disk.

                                                                                                                                                                                                        'localStorage'

                                                                                                                                                                                                      property authorizationParams

                                                                                                                                                                                                      authorizationParams?: ClientAuthorizationParams;
                                                                                                                                                                                                      • URL parameters that will be sent back to the Authorization Server. This can be known parameters defined by Auth0 or custom parameters that you define.

                                                                                                                                                                                                      property authorizeTimeoutInSeconds

                                                                                                                                                                                                      authorizeTimeoutInSeconds?: number;
                                                                                                                                                                                                      • A maximum number of seconds to wait before declaring background calls to /authorize as failed for timeout Defaults to 60s.

                                                                                                                                                                                                      property cache

                                                                                                                                                                                                      cache?: ICache;
                                                                                                                                                                                                      • Specify a custom cache implementation to use for token storage and retrieval. This setting takes precedence over cacheLocation if they are both specified.

                                                                                                                                                                                                      property cacheLocation

                                                                                                                                                                                                      cacheLocation?: CacheLocation;
                                                                                                                                                                                                      • The location to use when storing cache data. Valid values are memory or localstorage. The default setting is memory.

                                                                                                                                                                                                        Read more about [changing storage options in the Auth0 docs](https://auth0.com/docs/libraries/auth0-single-page-app-sdk#change-storage-options)

                                                                                                                                                                                                      property clientId

                                                                                                                                                                                                      clientId: string;
                                                                                                                                                                                                      • The Client ID found on your Application settings page

                                                                                                                                                                                                      property cookieDomain

                                                                                                                                                                                                      cookieDomain?: string;
                                                                                                                                                                                                      • The domain the cookie is accessible from. If not set, the cookie is scoped to the current domain, including the subdomain.

                                                                                                                                                                                                        Note: setting this incorrectly may cause silent authentication to stop working on page load.

                                                                                                                                                                                                        To keep a user logged in across multiple subdomains set this to your top-level domain and prefixed with a . (eg: .example.com).

                                                                                                                                                                                                      property createAnonymousSessionOnFailedSilentAuth

                                                                                                                                                                                                      createAnonymousSessionOnFailedSilentAuth?: boolean;
                                                                                                                                                                                                      • When true, checkSession() automatically creates (or restores) an anonymous session when the user is not authenticated. This does not affect standalone getTokenSilently() calls. checkSession() does not throw in this case.

                                                                                                                                                                                                        **Metadata limitation:** the session is created without metadata. If you need to attach metadata to the anonymous identity, do not use this option. Call auth0.anonymous.createSession({ metadata }) explicitly instead.

                                                                                                                                                                                                        false

                                                                                                                                                                                                      property domain

                                                                                                                                                                                                      domain: string;
                                                                                                                                                                                                      • Your Auth0 account domain such as 'example.auth0.com', 'example.eu.auth0.com' or , 'example.mycompany.com' (when using [custom domains](https://auth0.com/docs/custom-domains))

                                                                                                                                                                                                      property enterpriseConnect

                                                                                                                                                                                                      enterpriseConnect?: boolean;
                                                                                                                                                                                                      • Set to true when this client drives an Enterprise Connect login (enterprise SSO resolved from the email domain via isFederatedDomain and login_hint).

                                                                                                                                                                                                        Enterprise Connect issues no refresh token and resolves the organization from Home Realm Discovery at login. When enabled, the SDK warns at initialization if the configuration contradicts that: useRefreshTokens: true or offline_access in scope (no refresh token is issued) or a static organization (HRD resolves it, and a static value breaks multi-customer setups).

                                                                                                                                                                                                        This is a routing/telemetry flag only; it does not by itself change the login flow.

                                                                                                                                                                                                        **Default:** false

                                                                                                                                                                                                      property httpTimeoutInSeconds

                                                                                                                                                                                                      httpTimeoutInSeconds?: number;
                                                                                                                                                                                                      • Specify the timeout for HTTP calls using fetch. The default is 10 seconds.

                                                                                                                                                                                                      property interactiveErrorHandler

                                                                                                                                                                                                      interactiveErrorHandler?: InteractiveErrorHandler;
                                                                                                                                                                                                      • Configures automatic handling of interactive authentication errors.

                                                                                                                                                                                                        When set, the SDK intercepts mfa_required errors from getTokenSilently() and handles them automatically instead of throwing to the caller.

                                                                                                                                                                                                        - 'popup': Opens Universal Login in a popup to complete MFA. The original authorizationParams (audience, scope) are preserved. On success, the token is returned. On failure, popup errors are thrown.

                                                                                                                                                                                                        This option only affects getTokenSilently(). Other methods are not affected.

                                                                                                                                                                                                        undefined (MFA errors are thrown to the caller)

                                                                                                                                                                                                      property issuer

                                                                                                                                                                                                      issuer?: string;
                                                                                                                                                                                                      • The issuer to be used for validation of JWTs, optionally defaults to the domain above

                                                                                                                                                                                                      property leeway

                                                                                                                                                                                                      leeway?: number;
                                                                                                                                                                                                      • The value in seconds used to account for clock skew in JWT expirations. Typically, this value is no more than a minute or two at maximum. Defaults to 60s.

                                                                                                                                                                                                      property legacySameSiteCookie

                                                                                                                                                                                                      legacySameSiteCookie?: boolean;
                                                                                                                                                                                                      • Sets an additional cookie with no SameSite attribute to support legacy browsers that are not compatible with the latest SameSite changes. This will log a warning on modern browsers, you can disable the warning by setting this to false but be aware that some older useragents will not work, See https://www.chromium.org/updates/same-site/incompatible-clients Defaults to true

                                                                                                                                                                                                      property nowProvider

                                                                                                                                                                                                      nowProvider?: () => Promise<number> | number;
                                                                                                                                                                                                      • Modify the value used as the current time during the token validation.

                                                                                                                                                                                                        **Note**: Using this improperly can potentially compromise the token validation.

                                                                                                                                                                                                      property refreshTokenMode

                                                                                                                                                                                                      refreshTokenMode?: RefreshTokenMode;
                                                                                                                                                                                                      • Selects the refresh-token variant used when useRefreshTokens: true. Defaults to RefreshTokenMode.Offline.

                                                                                                                                                                                                        - RefreshTokenMode.Offline (default): rotating offline refresh tokens (offline_access). - RefreshTokenMode.Online: non-rotating, session-bound Online Refresh Tokens (online_access).

                                                                                                                                                                                                        Online mode requires useRefreshTokens: true and useDpop: true. The online_access and offline_access scopes are mutually exclusive.

                                                                                                                                                                                                      property sessionCheckExpiryDays

                                                                                                                                                                                                      sessionCheckExpiryDays?: number;
                                                                                                                                                                                                      • Number of days until the cookie auth0.is.authenticated will expire Defaults to 1.

                                                                                                                                                                                                      property sessionTransferTokenQueryParamName

                                                                                                                                                                                                      sessionTransferTokenQueryParamName?: string;
                                                                                                                                                                                                      • Query parameter name to extract the session transfer token from for Native to Web SSO.

                                                                                                                                                                                                        When set, the SDK automatically extracts the token from the specified URL query parameter and includes it as session_transfer_token in authorization requests. This enables seamless single sign-on when users transition from a native mobile application to a web application.

                                                                                                                                                                                                        After extraction, the token is automatically removed from the URL using window.history.replaceState() to prevent accidental reuse on subsequent authentication requests.

                                                                                                                                                                                                        **Default:** undefined (feature disabled)

                                                                                                                                                                                                        **Common values:** - 'session_transfer_token' - Standard parameter name - 'stt' - Shortened version - Custom parameter name of your choice

                                                                                                                                                                                                        Set to undefined to disable automatic extraction if you prefer to handle session transfer tokens manually.

                                                                                                                                                                                                        Example 1

                                                                                                                                                                                                        const auth0 = await createAuth0Client({
                                                                                                                                                                                                        domain: '<AUTH0_DOMAIN>',
                                                                                                                                                                                                        clientId: '<AUTH0_CLIENT_ID>',
                                                                                                                                                                                                        sessionTransferTokenQueryParamName: 'session_transfer_token'
                                                                                                                                                                                                        });

                                                                                                                                                                                                        See Also

                                                                                                                                                                                                        • https://auth0.com/docs/authenticate/single-sign-on/native-to-web

                                                                                                                                                                                                      property useCookiesForTransactions

                                                                                                                                                                                                      useCookiesForTransactions?: boolean;
                                                                                                                                                                                                      • If true, the SDK will use a cookie when storing information about the auth transaction while the user is going through the authentication flow on the authorization server.

                                                                                                                                                                                                        The default is false, in which case the SDK will use session storage.

                                                                                                                                                                                                        You might want to enable this if you rely on your users being able to authenticate using flows that may end up spanning across multiple tabs (e.g. magic links) or you cannot otherwise rely on session storage being available.

                                                                                                                                                                                                      property useDpop

                                                                                                                                                                                                      useDpop?: boolean;
                                                                                                                                                                                                      • If true, DPoP (OAuth 2.0 Demonstrating Proof of Possession, RFC9449) will be used to cryptographically bind tokens to this specific browser so they can't be used from a different device in case of a leak.

                                                                                                                                                                                                        The default setting is false.

                                                                                                                                                                                                      property useFormData

                                                                                                                                                                                                      useFormData?: boolean;
                                                                                                                                                                                                      • If true, data to the token endpoint is transmitted as x-www-form-urlencoded data, if false it will be transmitted as JSON. The default setting is true.

                                                                                                                                                                                                        **Note:** Setting this to false may affect you if you use Auth0 Rules and are sending custom, non-primitive data. If you disable this, please verify that your Auth0 Rules continue to work as intended.

                                                                                                                                                                                                      property useMrrt

                                                                                                                                                                                                      useMrrt?: boolean;
                                                                                                                                                                                                      • If true, the SDK will allow the refreshing of tokens using MRRT

                                                                                                                                                                                                      property useRefreshTokens

                                                                                                                                                                                                      useRefreshTokens?: boolean;
                                                                                                                                                                                                      • If true, refresh tokens are used to fetch new access tokens from the Auth0 server. If false, the standard technique of using a hidden iframe and the authorization_code grant with prompt=none is used. The default setting is false.

                                                                                                                                                                                                        Standard technique relies on cookies. Because browsers increasingly block third-party cookies, it requires a Custom Domain to function reliably. Refresh tokens serve as a fallback for environments where third-party cookies are blocked. Using a Custom Domain with this set to false is the most secure and recommended approach.

                                                                                                                                                                                                        **Note**: Use of refresh tokens must be enabled by an administrator on your Auth0 client application.

                                                                                                                                                                                                      property useRefreshTokensFallback

                                                                                                                                                                                                      useRefreshTokensFallback?: boolean;
                                                                                                                                                                                                      • If true, fallback to the technique of using a hidden iframe and the authorization_code grant with prompt=none when unable to use refresh tokens. If false, the iframe fallback is not used and errors relating to a failed refresh_token grant should be handled appropriately. The default setting is false.

                                                                                                                                                                                                        **Note**: There might be situations where doing silent auth with a Web Message response from an iframe is not possible, like when you're serving your application from the file system or a custom protocol (like in a Desktop or Native app). In situations like this you can disable the iframe fallback and handle the failed refresh_token grant and prompt the user to login interactively with loginWithRedirect or loginWithPopup."

                                                                                                                                                                                                        E.g. Using the file: protocol in an Electron application does not support that legacy technique.

                                                                                                                                                                                                        Example 1

                                                                                                                                                                                                        let token: string; try { token = await auth0.getTokenSilently(); } catch (e) { if (e.error === 'missing_refresh_token' || e.error === 'invalid_grant') { auth0.loginWithRedirect(); } }

                                                                                                                                                                                                      property workerUrl

                                                                                                                                                                                                      workerUrl?: string;
                                                                                                                                                                                                      • If provided, the SDK will load the token worker from this URL instead of the integrated blob. An example of when this is useful is if you have strict Content-Security-Policy (CSP) and wish to avoid needing to set worker-src: blob:. We recommend either serving the worker, which you can find in the module at <module_path>/dist/auth0-spa-js.worker.production.js, from the same host as your application or using the Auth0 CDN https://cdn.auth0.com/js/auth0-spa-js/<version>/auth0-spa-js.worker.production.js.

                                                                                                                                                                                                        **Note**: The worker is only used when useRefreshTokens: true, cacheLocation: 'memory', and the cache is not custom.

                                                                                                                                                                                                      interface AuthenticationResult

                                                                                                                                                                                                      interface AuthenticationResult {}

                                                                                                                                                                                                      property code

                                                                                                                                                                                                      code?: string;

                                                                                                                                                                                                        property connect_code

                                                                                                                                                                                                        connect_code?: string;
                                                                                                                                                                                                        • This is for the redirect from the connect account flow.

                                                                                                                                                                                                        property error

                                                                                                                                                                                                        error?: string;

                                                                                                                                                                                                          property error_description

                                                                                                                                                                                                          error_description?: string;

                                                                                                                                                                                                            property state

                                                                                                                                                                                                            state: string;

                                                                                                                                                                                                              interface Authenticator

                                                                                                                                                                                                              interface Authenticator {}
                                                                                                                                                                                                              • Represents an MFA authenticator enrolled by a user

                                                                                                                                                                                                              property active

                                                                                                                                                                                                              active: boolean;
                                                                                                                                                                                                              • Whether the authenticator is active

                                                                                                                                                                                                              property authenticatorType

                                                                                                                                                                                                              authenticatorType: AuthenticatorType;
                                                                                                                                                                                                              • Type of authenticator

                                                                                                                                                                                                              property createdAt

                                                                                                                                                                                                              createdAt?: string;
                                                                                                                                                                                                              • ISO 8601 timestamp when created

                                                                                                                                                                                                              property id

                                                                                                                                                                                                              id: string;
                                                                                                                                                                                                              • Unique identifier for the authenticator

                                                                                                                                                                                                              property lastAuth

                                                                                                                                                                                                              lastAuth?: string;
                                                                                                                                                                                                              • ISO 8601 timestamp of last authentication

                                                                                                                                                                                                              property name

                                                                                                                                                                                                              name?: string;
                                                                                                                                                                                                              • Optional friendly name

                                                                                                                                                                                                              property type

                                                                                                                                                                                                              type?: string;
                                                                                                                                                                                                              • Types of MFA challenges

                                                                                                                                                                                                              interface AuthorizationParams

                                                                                                                                                                                                              interface AuthorizationParams {}
                                                                                                                                                                                                              • Configuration

                                                                                                                                                                                                              property acr_values

                                                                                                                                                                                                              acr_values?: string;

                                                                                                                                                                                                                property audience

                                                                                                                                                                                                                audience?: string;
                                                                                                                                                                                                                • The default audience to be used for requesting API access.

                                                                                                                                                                                                                property connection

                                                                                                                                                                                                                connection?: string;
                                                                                                                                                                                                                • The name of the connection configured for your application. If null, it will redirect to the Auth0 Login Page and show the Login Widget.

                                                                                                                                                                                                                property display

                                                                                                                                                                                                                display?: 'page' | 'popup' | 'touch' | 'wap';
                                                                                                                                                                                                                • - 'page': displays the UI with a full page view - 'popup': displays the UI with a popup window - 'touch': displays the UI in a way that leverages a touch interface - 'wap': displays the UI with a "feature phone" type interface

                                                                                                                                                                                                                property experiment_id

                                                                                                                                                                                                                experiment_id?: string;
                                                                                                                                                                                                                • Forces a specific Experiment Center variant for this /authorize request instead of letting Auth0 assign one via its hash. Use together with variation_id.

                                                                                                                                                                                                                  Pass per-call (on loginWithRedirect/loginWithPopup) rather than at client construction time so the override does not bleed into silent prompt=none token-renewal calls, where Experiment Center does not run.

                                                                                                                                                                                                                  **Testing:** drive from test automation (e.g. Cypress/Playwright) with IDs from a CI environment variable against a staging tenant. Do not hard-code this in shipped app code.

                                                                                                                                                                                                                  **Production:** pass the variant decision from a feature-flag tool (e.g. LaunchDarkly) that has already decided which variant the user should see for this request.

                                                                                                                                                                                                                property id_token_hint

                                                                                                                                                                                                                id_token_hint?: string;
                                                                                                                                                                                                                • Previously issued ID Token.

                                                                                                                                                                                                                property invitation

                                                                                                                                                                                                                invitation?: string;
                                                                                                                                                                                                                • The Id of an invitation to accept. This is available from the user invitation URL that is given when participating in a user invitation flow.

                                                                                                                                                                                                                property login_hint

                                                                                                                                                                                                                login_hint?: string;
                                                                                                                                                                                                                • The user's email address or other identifier. When your app knows which user is trying to authenticate, you can provide this parameter to pre-fill the email box or select the right session for sign-in.

                                                                                                                                                                                                                  This currently only affects the classic Lock experience.

                                                                                                                                                                                                                property max_age

                                                                                                                                                                                                                max_age?: string | number;
                                                                                                                                                                                                                • Maximum allowable elapsed time (in seconds) since authentication. If the last time the user authenticated is greater than this value, the user must be reauthenticated.

                                                                                                                                                                                                                property organization

                                                                                                                                                                                                                organization?: string;
                                                                                                                                                                                                                • The organization to log in to.

                                                                                                                                                                                                                  This will specify an organization parameter in your user's login request.

                                                                                                                                                                                                                  - If you provide an Organization ID (a string with the prefix org_), it will be validated against the org_id claim of your user's ID Token. The validation is case-sensitive. - If you provide an Organization Name (a string *without* the prefix org_), it will be validated against the org_name claim of your user's ID Token. The validation is case-insensitive. To use an Organization Name you must have "Allow Organization Names in Authentication API" switched on in your Auth0 settings dashboard. More information is available on the [Auth0 documentation portal](https://auth0.com/docs/manage-users/organizations/configure-organizations/use-org-name-authentication-api)

                                                                                                                                                                                                                property prompt

                                                                                                                                                                                                                prompt?: 'none' | 'login' | 'consent' | 'select_account';
                                                                                                                                                                                                                • - 'none': do not prompt user for login or consent on reauthentication - 'login': prompt user for reauthentication - 'consent': prompt user for consent before processing request - 'select_account': prompt user to select an account

                                                                                                                                                                                                                property redirect_uri

                                                                                                                                                                                                                redirect_uri?: string;
                                                                                                                                                                                                                • The default URL where Auth0 will redirect your browser to with the authentication result. It must be whitelisted in the "Allowed Callback URLs" field in your Auth0 Application's settings. If not provided here, it should be provided in the other methods that provide authentication.

                                                                                                                                                                                                                property scope

                                                                                                                                                                                                                scope?: string;
                                                                                                                                                                                                                • The default scope to be used on authentication requests.

                                                                                                                                                                                                                  This defaults to profile email if not set. If you are setting extra scopes and require profile and email to be included then you must include them in the provided scope.

                                                                                                                                                                                                                  Note: The openid scope is **always applied** regardless of this setting.

                                                                                                                                                                                                                property screen_hint

                                                                                                                                                                                                                screen_hint?: 'signup' | 'login' | string;
                                                                                                                                                                                                                • Provides a hint to Auth0 as to what flow should be displayed. The default behavior is to show a login page but you can override this by passing 'signup' to show the signup page instead.

                                                                                                                                                                                                                  This only affects the New Universal Login Experience.

                                                                                                                                                                                                                property segment_id

                                                                                                                                                                                                                segment_id?: string;
                                                                                                                                                                                                                • An optional segment identifier to pass alongside experiment_id and variation_id when forcing a variant.

                                                                                                                                                                                                                property session_transfer_token

                                                                                                                                                                                                                session_transfer_token?: string;
                                                                                                                                                                                                                • Session transfer token from a native application for Native to Web SSO. When sessionTransferTokenQueryParamName is set, this is automatically extracted from the specified URL query parameter if present.

                                                                                                                                                                                                                  See Also

                                                                                                                                                                                                                  • https://auth0.com/docs/authenticate/single-sign-on/native-to-web

                                                                                                                                                                                                                property ui_locales

                                                                                                                                                                                                                ui_locales?: string;
                                                                                                                                                                                                                • The space-separated list of language tags, ordered by preference. For example: 'fr-CA fr en'.

                                                                                                                                                                                                                property variation_id

                                                                                                                                                                                                                variation_id?: string;
                                                                                                                                                                                                                • The variation to force within the experiment identified by experiment_id. Auth0 uses this value instead of computing an assignment for the current request. The override applies to this request only; the next login without these params reverts to normal server-side assignment.

                                                                                                                                                                                                                index signature

                                                                                                                                                                                                                [key: string]: any;
                                                                                                                                                                                                                • If you need to send custom parameters to the Authorization Server, make sure to use the original parameter name.

                                                                                                                                                                                                                interface AuthorizeOptions

                                                                                                                                                                                                                interface AuthorizeOptions extends AuthorizationParams {}

                                                                                                                                                                                                                property code_challenge

                                                                                                                                                                                                                code_challenge: string;

                                                                                                                                                                                                                  property code_challenge_method

                                                                                                                                                                                                                  code_challenge_method: string;

                                                                                                                                                                                                                    property nonce

                                                                                                                                                                                                                    nonce: string;

                                                                                                                                                                                                                      property redirect_uri

                                                                                                                                                                                                                      redirect_uri?: string;

                                                                                                                                                                                                                        property response_mode

                                                                                                                                                                                                                        response_mode: string;

                                                                                                                                                                                                                          property response_type

                                                                                                                                                                                                                          response_type: string;

                                                                                                                                                                                                                            property scope

                                                                                                                                                                                                                            scope: string;

                                                                                                                                                                                                                              property state

                                                                                                                                                                                                                              state: string;

                                                                                                                                                                                                                                interface ChallengeAuthenticatorParams

                                                                                                                                                                                                                                interface ChallengeAuthenticatorParams {}
                                                                                                                                                                                                                                • Parameters for initiating an MFA challenge

                                                                                                                                                                                                                                property authenticatorId

                                                                                                                                                                                                                                authenticatorId?: string;
                                                                                                                                                                                                                                • Specific authenticator to challenge (optional)

                                                                                                                                                                                                                                property challengeType

                                                                                                                                                                                                                                challengeType: 'otp' | 'oob';
                                                                                                                                                                                                                                • Type of challenge to initiate

                                                                                                                                                                                                                                property mfaToken

                                                                                                                                                                                                                                mfaToken: string;
                                                                                                                                                                                                                                • MFA token from mfa_required error or MFA-scoped access token

                                                                                                                                                                                                                                interface ChallengeResponse

                                                                                                                                                                                                                                interface ChallengeResponse {}
                                                                                                                                                                                                                                • Response from initiating an MFA challenge

                                                                                                                                                                                                                                property bindingMethod

                                                                                                                                                                                                                                bindingMethod?: string;
                                                                                                                                                                                                                                • Binding method for OOB (e.g., 'prompt')

                                                                                                                                                                                                                                property challengeType

                                                                                                                                                                                                                                challengeType: 'otp' | 'oob';
                                                                                                                                                                                                                                • Type of challenge created

                                                                                                                                                                                                                                property oobCode

                                                                                                                                                                                                                                oobCode?: string;
                                                                                                                                                                                                                                • Out-of-band code (for OOB challenges)

                                                                                                                                                                                                                                interface ClientAuthorizationParams

                                                                                                                                                                                                                                interface ClientAuthorizationParams extends Omit<AuthorizationParams, 'scope'> {}
                                                                                                                                                                                                                                • Configuration

                                                                                                                                                                                                                                property scope

                                                                                                                                                                                                                                scope?: string | Record<string, string>;

                                                                                                                                                                                                                                  interface ClientConfiguration

                                                                                                                                                                                                                                  interface ClientConfiguration {}
                                                                                                                                                                                                                                  • Configuration details exposed by the Auth0Client after initialization.

                                                                                                                                                                                                                                    Configuration

                                                                                                                                                                                                                                  property clientId

                                                                                                                                                                                                                                  clientId: string;
                                                                                                                                                                                                                                  • The Auth0 client ID that was configured

                                                                                                                                                                                                                                  property domain

                                                                                                                                                                                                                                  domain: string;
                                                                                                                                                                                                                                  • The Auth0 domain that was configured

                                                                                                                                                                                                                                  interface CompleteRequest

                                                                                                                                                                                                                                  interface CompleteRequest {}

                                                                                                                                                                                                                                    property auth_session

                                                                                                                                                                                                                                    auth_session: string;

                                                                                                                                                                                                                                      property code_verifier

                                                                                                                                                                                                                                      code_verifier?: string;

                                                                                                                                                                                                                                        property connect_code

                                                                                                                                                                                                                                        connect_code: string;

                                                                                                                                                                                                                                          property redirect_uri

                                                                                                                                                                                                                                          redirect_uri: string;

                                                                                                                                                                                                                                            interface CompleteResponse

                                                                                                                                                                                                                                            interface CompleteResponse {}

                                                                                                                                                                                                                                              property access_type

                                                                                                                                                                                                                                              access_type: 'offline';

                                                                                                                                                                                                                                                property connection

                                                                                                                                                                                                                                                connection: string;

                                                                                                                                                                                                                                                  property created_at

                                                                                                                                                                                                                                                  created_at: string;

                                                                                                                                                                                                                                                    property expires_at

                                                                                                                                                                                                                                                    expires_at?: string;

                                                                                                                                                                                                                                                      property id

                                                                                                                                                                                                                                                      id: string;

                                                                                                                                                                                                                                                        property scopes

                                                                                                                                                                                                                                                        scopes?: string[];

                                                                                                                                                                                                                                                          interface ConnectRequest

                                                                                                                                                                                                                                                          interface ConnectRequest {}

                                                                                                                                                                                                                                                            property authorization_params

                                                                                                                                                                                                                                                            authorization_params?: AuthorizationParams;

                                                                                                                                                                                                                                                              property code_challenge

                                                                                                                                                                                                                                                              code_challenge?: string;

                                                                                                                                                                                                                                                                property code_challenge_method

                                                                                                                                                                                                                                                                code_challenge_method?: 'S256';

                                                                                                                                                                                                                                                                  property connection

                                                                                                                                                                                                                                                                  connection: string;

                                                                                                                                                                                                                                                                    property redirect_uri

                                                                                                                                                                                                                                                                    redirect_uri: string;

                                                                                                                                                                                                                                                                      property scopes

                                                                                                                                                                                                                                                                      scopes?: string[];

                                                                                                                                                                                                                                                                        property state

                                                                                                                                                                                                                                                                        state?: string;

                                                                                                                                                                                                                                                                          interface ConnectResponse

                                                                                                                                                                                                                                                                          interface ConnectResponse {}

                                                                                                                                                                                                                                                                            property auth_session

                                                                                                                                                                                                                                                                            auth_session: string;

                                                                                                                                                                                                                                                                              property connect_params

                                                                                                                                                                                                                                                                              connect_params: {
                                                                                                                                                                                                                                                                              ticket: string;
                                                                                                                                                                                                                                                                              };

                                                                                                                                                                                                                                                                                property connect_uri

                                                                                                                                                                                                                                                                                connect_uri: string;

                                                                                                                                                                                                                                                                                  property expires_in

                                                                                                                                                                                                                                                                                  expires_in: number;

                                                                                                                                                                                                                                                                                    interface DecodedToken

                                                                                                                                                                                                                                                                                    interface DecodedToken {}

                                                                                                                                                                                                                                                                                      property claims

                                                                                                                                                                                                                                                                                      claims: IdToken;

                                                                                                                                                                                                                                                                                        property user

                                                                                                                                                                                                                                                                                        user: User;

                                                                                                                                                                                                                                                                                          interface EmailAuthenticationMethod

                                                                                                                                                                                                                                                                                          interface EmailAuthenticationMethod extends AuthenticationMethodWithMetadata {}

                                                                                                                                                                                                                                                                                            property email

                                                                                                                                                                                                                                                                                            email: string;

                                                                                                                                                                                                                                                                                              property type

                                                                                                                                                                                                                                                                                              type: 'email';

                                                                                                                                                                                                                                                                                                interface EmailEnrollmentChallengeOptions

                                                                                                                                                                                                                                                                                                interface EmailEnrollmentChallengeOptions {}

                                                                                                                                                                                                                                                                                                  property email

                                                                                                                                                                                                                                                                                                  email: string;

                                                                                                                                                                                                                                                                                                    property type

                                                                                                                                                                                                                                                                                                    type: 'email';

                                                                                                                                                                                                                                                                                                      interface EmailEnrollmentChallengeResponse

                                                                                                                                                                                                                                                                                                      interface EmailEnrollmentChallengeResponse extends EnrollmentChallengeBaseResponse {}

                                                                                                                                                                                                                                                                                                        property type

                                                                                                                                                                                                                                                                                                        type: 'email';

                                                                                                                                                                                                                                                                                                          interface EmailEnrollmentVerifyOptions

                                                                                                                                                                                                                                                                                                          interface EmailEnrollmentVerifyOptions extends EnrollmentVerifyBaseOptions {}

                                                                                                                                                                                                                                                                                                            property otp_code

                                                                                                                                                                                                                                                                                                            otp_code: string;

                                                                                                                                                                                                                                                                                                              property type

                                                                                                                                                                                                                                                                                                              type: 'email';

                                                                                                                                                                                                                                                                                                                interface EnrollEmailParams

                                                                                                                                                                                                                                                                                                                interface EnrollEmailParams extends EnrollBaseParams {}
                                                                                                                                                                                                                                                                                                                • Email enrollment parameters

                                                                                                                                                                                                                                                                                                                property email

                                                                                                                                                                                                                                                                                                                email?: string;
                                                                                                                                                                                                                                                                                                                • Email address (optional, uses user's email if not provided)

                                                                                                                                                                                                                                                                                                                property factorType

                                                                                                                                                                                                                                                                                                                factorType: 'email';
                                                                                                                                                                                                                                                                                                                • The factor type for enrollment

                                                                                                                                                                                                                                                                                                                interface EnrollmentFactor

                                                                                                                                                                                                                                                                                                                interface EnrollmentFactor {}
                                                                                                                                                                                                                                                                                                                • Enrollment factor returned by getEnrollmentFactors

                                                                                                                                                                                                                                                                                                                property type

                                                                                                                                                                                                                                                                                                                type: string;
                                                                                                                                                                                                                                                                                                                • Type of enrollment factor available

                                                                                                                                                                                                                                                                                                                interface EnrollOtpParams

                                                                                                                                                                                                                                                                                                                interface EnrollOtpParams extends EnrollBaseParams {}
                                                                                                                                                                                                                                                                                                                • OTP (Time-based One-Time Password) enrollment parameters

                                                                                                                                                                                                                                                                                                                property factorType

                                                                                                                                                                                                                                                                                                                factorType: 'otp';
                                                                                                                                                                                                                                                                                                                • The factor type for enrollment

                                                                                                                                                                                                                                                                                                                interface EnrollPushParams

                                                                                                                                                                                                                                                                                                                interface EnrollPushParams extends EnrollBaseParams {}
                                                                                                                                                                                                                                                                                                                • Push notification enrollment parameters

                                                                                                                                                                                                                                                                                                                property factorType

                                                                                                                                                                                                                                                                                                                factorType: 'push';
                                                                                                                                                                                                                                                                                                                • The factor type for enrollment

                                                                                                                                                                                                                                                                                                                interface EnrollSmsParams

                                                                                                                                                                                                                                                                                                                interface EnrollSmsParams extends EnrollBaseParams {}
                                                                                                                                                                                                                                                                                                                • SMS enrollment parameters

                                                                                                                                                                                                                                                                                                                property factorType

                                                                                                                                                                                                                                                                                                                factorType: 'sms';
                                                                                                                                                                                                                                                                                                                • The factor type for enrollment

                                                                                                                                                                                                                                                                                                                property phoneNumber

                                                                                                                                                                                                                                                                                                                phoneNumber: string;
                                                                                                                                                                                                                                                                                                                • Phone number in E.164 format (required for SMS)

                                                                                                                                                                                                                                                                                                                interface EnrollVoiceParams

                                                                                                                                                                                                                                                                                                                interface EnrollVoiceParams extends EnrollBaseParams {}
                                                                                                                                                                                                                                                                                                                • Voice enrollment parameters

                                                                                                                                                                                                                                                                                                                property factorType

                                                                                                                                                                                                                                                                                                                factorType: 'voice';
                                                                                                                                                                                                                                                                                                                • The factor type for enrollment

                                                                                                                                                                                                                                                                                                                property phoneNumber

                                                                                                                                                                                                                                                                                                                phoneNumber: string;
                                                                                                                                                                                                                                                                                                                • Phone number in E.164 format (required for voice)

                                                                                                                                                                                                                                                                                                                interface ErrorResponse

                                                                                                                                                                                                                                                                                                                interface ErrorResponse {}

                                                                                                                                                                                                                                                                                                                  property detail

                                                                                                                                                                                                                                                                                                                  detail: string;

                                                                                                                                                                                                                                                                                                                    property status

                                                                                                                                                                                                                                                                                                                    status: number;

                                                                                                                                                                                                                                                                                                                      property title

                                                                                                                                                                                                                                                                                                                      title: string;

                                                                                                                                                                                                                                                                                                                        property type

                                                                                                                                                                                                                                                                                                                        type: string;

                                                                                                                                                                                                                                                                                                                          property validation_errors

                                                                                                                                                                                                                                                                                                                          validation_errors?: {
                                                                                                                                                                                                                                                                                                                          detail: string;
                                                                                                                                                                                                                                                                                                                          field?: string;
                                                                                                                                                                                                                                                                                                                          pointer?: string;
                                                                                                                                                                                                                                                                                                                          source?: string;
                                                                                                                                                                                                                                                                                                                          }[];

                                                                                                                                                                                                                                                                                                                            interface Factor

                                                                                                                                                                                                                                                                                                                            interface Factor {}

                                                                                                                                                                                                                                                                                                                              property type

                                                                                                                                                                                                                                                                                                                              type: AuthenticationMethodType;

                                                                                                                                                                                                                                                                                                                                property usage

                                                                                                                                                                                                                                                                                                                                usage?: ('primary' | 'secondary')[];

                                                                                                                                                                                                                                                                                                                                  interface GetTokenSilentlyOptions

                                                                                                                                                                                                                                                                                                                                  interface GetTokenSilentlyOptions {}
                                                                                                                                                                                                                                                                                                                                  • Tokens & Users

                                                                                                                                                                                                                                                                                                                                  property authorizationParams

                                                                                                                                                                                                                                                                                                                                  authorizationParams?: {
                                                                                                                                                                                                                                                                                                                                  /**
                                                                                                                                                                                                                                                                                                                                  * There's no actual redirect when getting a token silently,
                                                                                                                                                                                                                                                                                                                                  * but, according to the spec, a `redirect_uri` param is required.
                                                                                                                                                                                                                                                                                                                                  * Auth0 uses this parameter to validate that the current `origin`
                                                                                                                                                                                                                                                                                                                                  * matches the `redirect_uri` `origin` when sending the response.
                                                                                                                                                                                                                                                                                                                                  * It must be whitelisted in the "Allowed Web Origins" in your
                                                                                                                                                                                                                                                                                                                                  * Auth0 Application's settings.
                                                                                                                                                                                                                                                                                                                                  */
                                                                                                                                                                                                                                                                                                                                  redirect_uri?: string;
                                                                                                                                                                                                                                                                                                                                  /**
                                                                                                                                                                                                                                                                                                                                  * The scope that was used in the authentication request
                                                                                                                                                                                                                                                                                                                                  */
                                                                                                                                                                                                                                                                                                                                  scope?: string;
                                                                                                                                                                                                                                                                                                                                  /**
                                                                                                                                                                                                                                                                                                                                  * The audience that was used in the authentication request
                                                                                                                                                                                                                                                                                                                                  */
                                                                                                                                                                                                                                                                                                                                  audience?: string;
                                                                                                                                                                                                                                                                                                                                  /**
                                                                                                                                                                                                                                                                                                                                  * If you need to send custom parameters to the Authorization Server,
                                                                                                                                                                                                                                                                                                                                  * make sure to use the original parameter name.
                                                                                                                                                                                                                                                                                                                                  */
                                                                                                                                                                                                                                                                                                                                  [key: string]: any;
                                                                                                                                                                                                                                                                                                                                  };
                                                                                                                                                                                                                                                                                                                                  • Parameters that will be sent back to Auth0 as part of a request.

                                                                                                                                                                                                                                                                                                                                  property cacheMode

                                                                                                                                                                                                                                                                                                                                  cacheMode?: 'on' | 'off' | 'cache-only';
                                                                                                                                                                                                                                                                                                                                  • When off, ignores the cache and always sends a request to Auth0. Concurrent off calls for the same audience and scope share a single request, but never share a request with on or cache-only calls. When cache-only, only reads from the cache and never sends a request to Auth0. Defaults to on, where it both reads from the cache and sends a request to Auth0 as needed.

                                                                                                                                                                                                                                                                                                                                  property detailedResponse

                                                                                                                                                                                                                                                                                                                                  detailedResponse?: boolean;
                                                                                                                                                                                                                                                                                                                                  • If true, the full response from the /oauth/token endpoint (or the cache, if the cache was used) is returned (minus refresh_token if one was issued). Otherwise, just the access token is returned.

                                                                                                                                                                                                                                                                                                                                    The default is false.

                                                                                                                                                                                                                                                                                                                                  property timeoutInSeconds

                                                                                                                                                                                                                                                                                                                                  timeoutInSeconds?: number;
                                                                                                                                                                                                                                                                                                                                  • A maximum number of seconds to wait before declaring the background /authorize call as failed for timeout Defaults to 60s.

                                                                                                                                                                                                                                                                                                                                  interface GetTokenWithPopupOptions

                                                                                                                                                                                                                                                                                                                                  interface GetTokenWithPopupOptions extends PopupLoginOptions {}
                                                                                                                                                                                                                                                                                                                                  • Tokens & Users

                                                                                                                                                                                                                                                                                                                                  property cacheMode

                                                                                                                                                                                                                                                                                                                                  cacheMode?: 'on' | 'off' | 'cache-only';
                                                                                                                                                                                                                                                                                                                                  • When off, ignores the cache and always sends a request to Auth0. When cache-only, only reads from the cache and never sends a request to Auth0. Defaults to on, where it both reads from the cache and sends a request to Auth0 as needed.

                                                                                                                                                                                                                                                                                                                                  interface GetUserProfileOptions

                                                                                                                                                                                                                                                                                                                                  interface GetUserProfileOptions {}

                                                                                                                                                                                                                                                                                                                                    property fields

                                                                                                                                                                                                                                                                                                                                    fields?: string[];

                                                                                                                                                                                                                                                                                                                                      property includeFields

                                                                                                                                                                                                                                                                                                                                      includeFields?: boolean;

                                                                                                                                                                                                                                                                                                                                        interface ICache

                                                                                                                                                                                                                                                                                                                                        interface ICache {}

                                                                                                                                                                                                                                                                                                                                          method allKeys

                                                                                                                                                                                                                                                                                                                                          allKeys: () => MaybePromise<string[]>;

                                                                                                                                                                                                                                                                                                                                            method get

                                                                                                                                                                                                                                                                                                                                            get: <T = Cacheable>(key: string) => MaybePromise<T | undefined>;

                                                                                                                                                                                                                                                                                                                                              method remove

                                                                                                                                                                                                                                                                                                                                              remove: (key: string) => MaybePromise<void>;

                                                                                                                                                                                                                                                                                                                                                method set

                                                                                                                                                                                                                                                                                                                                                set: <T = Cacheable>(key: string, entry: T) => MaybePromise<void>;

                                                                                                                                                                                                                                                                                                                                                  interface IdToken

                                                                                                                                                                                                                                                                                                                                                  interface IdToken {}
                                                                                                                                                                                                                                                                                                                                                  • Tokens & Users

                                                                                                                                                                                                                                                                                                                                                  property acr

                                                                                                                                                                                                                                                                                                                                                  acr?: string;

                                                                                                                                                                                                                                                                                                                                                    property act

                                                                                                                                                                                                                                                                                                                                                    act?: ActClaim;
                                                                                                                                                                                                                                                                                                                                                    • The actor claim, present in ID tokens returned via token exchange responses. Identifies the acting party that has been delegated authority to act on behalf of the subject. Set via Auth0 Actions using the setActor command.

                                                                                                                                                                                                                                                                                                                                                    property address

                                                                                                                                                                                                                                                                                                                                                    address?: string;

                                                                                                                                                                                                                                                                                                                                                      property amr

                                                                                                                                                                                                                                                                                                                                                      amr?: string[];

                                                                                                                                                                                                                                                                                                                                                        property at_hash

                                                                                                                                                                                                                                                                                                                                                        at_hash?: string;

                                                                                                                                                                                                                                                                                                                                                          property aud

                                                                                                                                                                                                                                                                                                                                                          aud?: string;

                                                                                                                                                                                                                                                                                                                                                            property auth_time

                                                                                                                                                                                                                                                                                                                                                            auth_time?: string;

                                                                                                                                                                                                                                                                                                                                                              property azp

                                                                                                                                                                                                                                                                                                                                                              azp?: string;

                                                                                                                                                                                                                                                                                                                                                                property birthdate

                                                                                                                                                                                                                                                                                                                                                                birthdate?: string;

                                                                                                                                                                                                                                                                                                                                                                  property c_hash

                                                                                                                                                                                                                                                                                                                                                                  c_hash?: string;

                                                                                                                                                                                                                                                                                                                                                                    property cnf

                                                                                                                                                                                                                                                                                                                                                                    cnf?: string;

                                                                                                                                                                                                                                                                                                                                                                      property email

                                                                                                                                                                                                                                                                                                                                                                      email?: string;

                                                                                                                                                                                                                                                                                                                                                                        property email_verified

                                                                                                                                                                                                                                                                                                                                                                        email_verified?: boolean;

                                                                                                                                                                                                                                                                                                                                                                          property exp

                                                                                                                                                                                                                                                                                                                                                                          exp?: number;

                                                                                                                                                                                                                                                                                                                                                                            property family_name

                                                                                                                                                                                                                                                                                                                                                                            family_name?: string;

                                                                                                                                                                                                                                                                                                                                                                              property gender

                                                                                                                                                                                                                                                                                                                                                                              gender?: string;

                                                                                                                                                                                                                                                                                                                                                                                property given_name

                                                                                                                                                                                                                                                                                                                                                                                given_name?: string;

                                                                                                                                                                                                                                                                                                                                                                                  property iat

                                                                                                                                                                                                                                                                                                                                                                                  iat?: number;

                                                                                                                                                                                                                                                                                                                                                                                    property iss

                                                                                                                                                                                                                                                                                                                                                                                    iss?: string;

                                                                                                                                                                                                                                                                                                                                                                                      property jti

                                                                                                                                                                                                                                                                                                                                                                                      jti?: string;

                                                                                                                                                                                                                                                                                                                                                                                        property locale

                                                                                                                                                                                                                                                                                                                                                                                        locale?: string;

                                                                                                                                                                                                                                                                                                                                                                                          property middle_name

                                                                                                                                                                                                                                                                                                                                                                                          middle_name?: string;

                                                                                                                                                                                                                                                                                                                                                                                            property name

                                                                                                                                                                                                                                                                                                                                                                                            name?: string;

                                                                                                                                                                                                                                                                                                                                                                                              property nbf

                                                                                                                                                                                                                                                                                                                                                                                              nbf?: number;

                                                                                                                                                                                                                                                                                                                                                                                                property nickname

                                                                                                                                                                                                                                                                                                                                                                                                nickname?: string;

                                                                                                                                                                                                                                                                                                                                                                                                  property nonce

                                                                                                                                                                                                                                                                                                                                                                                                  nonce?: string;

                                                                                                                                                                                                                                                                                                                                                                                                    property org_id

                                                                                                                                                                                                                                                                                                                                                                                                    org_id?: string;

                                                                                                                                                                                                                                                                                                                                                                                                      property org_name

                                                                                                                                                                                                                                                                                                                                                                                                      org_name?: string;

                                                                                                                                                                                                                                                                                                                                                                                                        property phone_number

                                                                                                                                                                                                                                                                                                                                                                                                        phone_number?: string;

                                                                                                                                                                                                                                                                                                                                                                                                          property phone_number_verified

                                                                                                                                                                                                                                                                                                                                                                                                          phone_number_verified?: boolean;

                                                                                                                                                                                                                                                                                                                                                                                                            property picture

                                                                                                                                                                                                                                                                                                                                                                                                            picture?: string;

                                                                                                                                                                                                                                                                                                                                                                                                              property preferred_username

                                                                                                                                                                                                                                                                                                                                                                                                              preferred_username?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                property profile

                                                                                                                                                                                                                                                                                                                                                                                                                profile?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                  property session_expiry

                                                                                                                                                                                                                                                                                                                                                                                                                  session_expiry?: number;
                                                                                                                                                                                                                                                                                                                                                                                                                  • IPSIE session expiry ceiling (Unix timestamp in seconds). When present, the SDK will not return tokens after this point in time.

                                                                                                                                                                                                                                                                                                                                                                                                                  property sid

                                                                                                                                                                                                                                                                                                                                                                                                                  sid?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                    property sub_jwk

                                                                                                                                                                                                                                                                                                                                                                                                                    sub_jwk?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                      property updated_at

                                                                                                                                                                                                                                                                                                                                                                                                                      updated_at?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                        property website

                                                                                                                                                                                                                                                                                                                                                                                                                        website?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                          property zoneinfo

                                                                                                                                                                                                                                                                                                                                                                                                                          zoneinfo?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                            index signature

                                                                                                                                                                                                                                                                                                                                                                                                                            [key: string]: any;

                                                                                                                                                                                                                                                                                                                                                                                                                              interface JWTVerifyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                              interface JWTVerifyOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                              property aud

                                                                                                                                                                                                                                                                                                                                                                                                                              aud: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                property id_token

                                                                                                                                                                                                                                                                                                                                                                                                                                id_token: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                  property iss

                                                                                                                                                                                                                                                                                                                                                                                                                                  iss: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                    property leeway

                                                                                                                                                                                                                                                                                                                                                                                                                                    leeway?: number;

                                                                                                                                                                                                                                                                                                                                                                                                                                      property max_age

                                                                                                                                                                                                                                                                                                                                                                                                                                      max_age?: number;

                                                                                                                                                                                                                                                                                                                                                                                                                                        property nonce

                                                                                                                                                                                                                                                                                                                                                                                                                                        nonce?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                          property now

                                                                                                                                                                                                                                                                                                                                                                                                                                          now?: number;

                                                                                                                                                                                                                                                                                                                                                                                                                                            property organization

                                                                                                                                                                                                                                                                                                                                                                                                                                            organization?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                              interface LogoutOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                              interface LogoutOptions extends LogoutUrlOptions {}
                                                                                                                                                                                                                                                                                                                                                                                                                                              • Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                              property onRedirect

                                                                                                                                                                                                                                                                                                                                                                                                                                              onRedirect?: (url: string) => Promise<void>;
                                                                                                                                                                                                                                                                                                                                                                                                                                              • Used to control the redirect and not rely on the SDK to do the actual redirect.

                                                                                                                                                                                                                                                                                                                                                                                                                                                Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                await auth0.logout({ async onRedirect(url) { window.location.replace(url); } });

                                                                                                                                                                                                                                                                                                                                                                                                                                                Deprecated

                                                                                                                                                                                                                                                                                                                                                                                                                                                since v2.0.1, use openUrl instead.

                                                                                                                                                                                                                                                                                                                                                                                                                                              property openUrl

                                                                                                                                                                                                                                                                                                                                                                                                                                              openUrl?: false | ((url: string) => Promise<void> | void);
                                                                                                                                                                                                                                                                                                                                                                                                                                              • Used to control the redirect and not rely on the SDK to do the actual redirect.

                                                                                                                                                                                                                                                                                                                                                                                                                                                Set to false to disable the redirect, or provide a function to handle the actual redirect yourself.

                                                                                                                                                                                                                                                                                                                                                                                                                                                Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                await auth0.logout({ openUrl(url) { window.location.replace(url); } });

                                                                                                                                                                                                                                                                                                                                                                                                                                                Example 2

                                                                                                                                                                                                                                                                                                                                                                                                                                                import { Browser } from '@capacitor/browser';

                                                                                                                                                                                                                                                                                                                                                                                                                                                await auth0.logout({ async openUrl(url) { await Browser.open({ url }); } });

                                                                                                                                                                                                                                                                                                                                                                                                                                              interface LogoutUrlOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                              interface LogoutUrlOptions {}
                                                                                                                                                                                                                                                                                                                                                                                                                                              • Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                              property clientId

                                                                                                                                                                                                                                                                                                                                                                                                                                              clientId?: string | null;
                                                                                                                                                                                                                                                                                                                                                                                                                                              • The clientId of your application.

                                                                                                                                                                                                                                                                                                                                                                                                                                                If this property is not set, then the clientId that was used during initialization of the SDK is sent to the logout endpoint.

                                                                                                                                                                                                                                                                                                                                                                                                                                                If this property is set to null, then no client ID value is sent to the logout endpoint.

                                                                                                                                                                                                                                                                                                                                                                                                                                                [Read more about how redirecting after logout works](https://auth0.com/docs/logout/guides/redirect-users-after-logout)

                                                                                                                                                                                                                                                                                                                                                                                                                                              property logoutParams

                                                                                                                                                                                                                                                                                                                                                                                                                                              logoutParams?: {
                                                                                                                                                                                                                                                                                                                                                                                                                                              /**
                                                                                                                                                                                                                                                                                                                                                                                                                                              * When supported by the upstream identity provider,
                                                                                                                                                                                                                                                                                                                                                                                                                                              * forces the user to logout of their identity provider
                                                                                                                                                                                                                                                                                                                                                                                                                                              * and from Auth0.
                                                                                                                                                                                                                                                                                                                                                                                                                                              * [Read more about how federated logout works at Auth0](https://auth0.com/docs/logout/guides/logout-idps)
                                                                                                                                                                                                                                                                                                                                                                                                                                              */
                                                                                                                                                                                                                                                                                                                                                                                                                                              federated?: boolean;
                                                                                                                                                                                                                                                                                                                                                                                                                                              /**
                                                                                                                                                                                                                                                                                                                                                                                                                                              * The URL where Auth0 will redirect your browser to after the logout.
                                                                                                                                                                                                                                                                                                                                                                                                                                              *
                                                                                                                                                                                                                                                                                                                                                                                                                                              * **Note**: If the `client_id` parameter is included, the
                                                                                                                                                                                                                                                                                                                                                                                                                                              * `returnTo` URL that is provided must be listed in the
                                                                                                                                                                                                                                                                                                                                                                                                                                              * Application's "Allowed Logout URLs" in the Auth0 dashboard.
                                                                                                                                                                                                                                                                                                                                                                                                                                              * However, if the `client_id` parameter is not included, the
                                                                                                                                                                                                                                                                                                                                                                                                                                              * `returnTo` URL must be listed in the "Allowed Logout URLs" at
                                                                                                                                                                                                                                                                                                                                                                                                                                              * the account level in the Auth0 dashboard.
                                                                                                                                                                                                                                                                                                                                                                                                                                              *
                                                                                                                                                                                                                                                                                                                                                                                                                                              * [Read more about how redirecting after logout works](https://auth0.com/docs/logout/guides/redirect-users-after-logout)
                                                                                                                                                                                                                                                                                                                                                                                                                                              */
                                                                                                                                                                                                                                                                                                                                                                                                                                              returnTo?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                              /**
                                                                                                                                                                                                                                                                                                                                                                                                                                              * If you need to send custom parameters to the logout endpoint, make sure to use the original parameter name.
                                                                                                                                                                                                                                                                                                                                                                                                                                              */
                                                                                                                                                                                                                                                                                                                                                                                                                                              [key: string]: any;
                                                                                                                                                                                                                                                                                                                                                                                                                                              };
                                                                                                                                                                                                                                                                                                                                                                                                                                              • Parameters to pass to the logout endpoint. This can be known parameters defined by Auth0 or custom parameters you wish to provide.

                                                                                                                                                                                                                                                                                                                                                                                                                                              interface MfaRequirements

                                                                                                                                                                                                                                                                                                                                                                                                                                              interface MfaRequirements {}
                                                                                                                                                                                                                                                                                                                                                                                                                                              • MFA requirements from an mfa_required error response

                                                                                                                                                                                                                                                                                                                                                                                                                                                Errors

                                                                                                                                                                                                                                                                                                                                                                                                                                              property challenge

                                                                                                                                                                                                                                                                                                                                                                                                                                              challenge?: Array<{
                                                                                                                                                                                                                                                                                                                                                                                                                                              type: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                              }>;
                                                                                                                                                                                                                                                                                                                                                                                                                                              • Required challenge types

                                                                                                                                                                                                                                                                                                                                                                                                                                              property enroll

                                                                                                                                                                                                                                                                                                                                                                                                                                              enroll?: Array<{
                                                                                                                                                                                                                                                                                                                                                                                                                                              type: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                              }>;
                                                                                                                                                                                                                                                                                                                                                                                                                                              • Required enrollment types

                                                                                                                                                                                                                                                                                                                                                                                                                                              interface OAuthTokenOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                              interface OAuthTokenOptions extends TokenEndpointOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                              property audience

                                                                                                                                                                                                                                                                                                                                                                                                                                              audience: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                property code

                                                                                                                                                                                                                                                                                                                                                                                                                                                code: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                  property code_verifier

                                                                                                                                                                                                                                                                                                                                                                                                                                                  code_verifier: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                    property redirect_uri

                                                                                                                                                                                                                                                                                                                                                                                                                                                    redirect_uri: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                      property scope

                                                                                                                                                                                                                                                                                                                                                                                                                                                      scope: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface OobEnrollmentResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface OobEnrollmentResponse {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Response when enrolling an OOB authenticator

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property authenticatorType

                                                                                                                                                                                                                                                                                                                                                                                                                                                        authenticatorType: 'oob';
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Authenticator type

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property barcodeUri

                                                                                                                                                                                                                                                                                                                                                                                                                                                        barcodeUri?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • URI for QR code (for Push/Guardian enrollment)

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property bindingMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                        bindingMethod?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Binding method (e.g., 'prompt' for user code entry)

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property id

                                                                                                                                                                                                                                                                                                                                                                                                                                                        id?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Authenticator ID

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property oobChannel

                                                                                                                                                                                                                                                                                                                                                                                                                                                        oobChannel: OobChannel;
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Delivery channel used

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property oobCode

                                                                                                                                                                                                                                                                                                                                                                                                                                                        oobCode?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Out-of-band code for verification

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property recoveryCodes

                                                                                                                                                                                                                                                                                                                                                                                                                                                        recoveryCodes?: string[];
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Recovery codes (generated when enrolling first MFA factor)

                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface OtpEnrollmentResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface OtpEnrollmentResponse {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Response when enrolling an OTP authenticator

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property authenticatorType

                                                                                                                                                                                                                                                                                                                                                                                                                                                        authenticatorType: 'otp';
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Authenticator type

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property barcodeUri

                                                                                                                                                                                                                                                                                                                                                                                                                                                        barcodeUri: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • URI for generating QR code (otpauth://...)

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property id

                                                                                                                                                                                                                                                                                                                                                                                                                                                        id?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Authenticator ID

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property recoveryCodes

                                                                                                                                                                                                                                                                                                                                                                                                                                                        recoveryCodes?: string[];
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Recovery codes for account recovery

                                                                                                                                                                                                                                                                                                                                                                                                                                                        property secret

                                                                                                                                                                                                                                                                                                                                                                                                                                                        secret: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Base32-encoded secret for TOTP generation

                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface PasskeyAuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface PasskeyAuthenticationMethod extends AuthenticationMethodBase {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                          property aaguid

                                                                                                                                                                                                                                                                                                                                                                                                                                                          aaguid?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                            property credential_backed_up

                                                                                                                                                                                                                                                                                                                                                                                                                                                            credential_backed_up: boolean;

                                                                                                                                                                                                                                                                                                                                                                                                                                                              property credential_device_type

                                                                                                                                                                                                                                                                                                                                                                                                                                                              credential_device_type: 'single_device' | 'multi_device';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                property identity_user_id

                                                                                                                                                                                                                                                                                                                                                                                                                                                                identity_user_id: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property key_id

                                                                                                                                                                                                                                                                                                                                                                                                                                                                  key_id: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property last_auth_at

                                                                                                                                                                                                                                                                                                                                                                                                                                                                    last_auth_at?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property public_key

                                                                                                                                                                                                                                                                                                                                                                                                                                                                      public_key: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property relying_party_id

                                                                                                                                                                                                                                                                                                                                                                                                                                                                        relying_party_id?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property transports

                                                                                                                                                                                                                                                                                                                                                                                                                                                                          transports?: string[];

                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type: 'passkey';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property user_agent

                                                                                                                                                                                                                                                                                                                                                                                                                                                                              user_agent?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property user_handle

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                user_handle: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface PasskeyEnrollmentChallengeOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface PasskeyEnrollmentChallengeOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property connection

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    connection?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property identity_user_id

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      identity_user_id?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type: 'passkey';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          interface PasskeyEnrollmentChallengeResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          interface PasskeyEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          extends EnrollmentChallengeBaseResponse {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property authn_params_public_key

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            authn_params_public_key: PasskeyCreationOptions;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type: 'passkey';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                interface PasskeyEnrollmentVerifyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                interface PasskeyEnrollmentVerifyOptions extends EnrollmentVerifyBaseOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property authn_response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  authn_response: PasskeyCredentialResponse;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    type: 'passkey';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface PasskeyErrorResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface PasskeyErrorResponse {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property error

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        error: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property error_description

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          error_description: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property message

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            message?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PasswordAuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PasswordAuthenticationMethod extends AuthenticationMethodBase {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property identity_user_id

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                identity_user_id: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property last_password_reset

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  last_password_reset?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    type: 'password';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface PasswordEnrollmentChallengeOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface PasswordEnrollmentChallengeOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property connection

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        connection?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property identity_user_id

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          identity_user_id?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type: 'password';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PasswordEnrollmentChallengeResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PasswordEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              extends EnrollmentChallengeBaseResponse {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property policy

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                policy: PasswordPolicy;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type: 'password';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface PasswordEnrollmentVerifyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface PasswordEnrollmentVerifyOptions extends EnrollmentVerifyBaseOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property new_password

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      new_password: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type: 'password';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          interface PasswordPolicy

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          interface PasswordPolicy {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property complexity

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            complexity: {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            min_length: number;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            character_types: ('uppercase' | 'lowercase' | 'number' | 'special')[];
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            character_type_rule: 'all' | 'three_of_four';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            identical_characters: 'allow' | 'block';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            sequential_characters: 'allow' | 'block';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            max_length_exceeded: 'truncate' | 'error';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property dictionary

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              dictionary: {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              active: boolean;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              default: 'en_10k' | 'en_100k';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property history

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                history: {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                active: boolean;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                size: number;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property profile_data

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  profile_data: {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  active: boolean;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  blocked_fields: string[];
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface PhoneAuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface PhoneAuthenticationMethod extends AuthenticationMethodWithMetadata {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property phone_number

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      phone_number: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property preferred_authentication_method

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        preferred_authentication_method: 'sms' | 'voice';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          type: 'phone';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface PhoneEnrollmentChallengeOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface PhoneEnrollmentChallengeOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property phone_number

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              phone_number: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property preferred_authentication_method

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                preferred_authentication_method?: 'sms' | 'voice';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type: 'phone';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface PhoneEnrollmentChallengeResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface PhoneEnrollmentChallengeResponse extends EnrollmentChallengeBaseResponse {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      type: 'phone';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface PhoneEnrollmentVerifyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface PhoneEnrollmentVerifyOptions extends EnrollmentVerifyBaseOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property otp_code

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          otp_code: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type: 'phone';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PopupConfigOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PopupConfigOptions {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property closePopup

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              closePopup?: boolean;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Controls whether the SDK automatically closes the popup window.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                - true (default): SDK closes the popup automatically after receiving the authorization response - false: SDK does not close the popup. The caller is responsible for closing it, including on errors.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Setting this to false is useful when you need full control over the popup lifecycle, such as in Chrome extensions where closing the popup too early can terminate the extension's service worker before authentication completes.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                When closePopup: false, you should close the popup in a try/finally block:

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                const popup = window.open('', '_blank');
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                try {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                await auth0.loginWithPopup({}, { popup, closePopup: false });
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                } finally {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                popup.close();
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                }

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                true

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property popup

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              popup?: any;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Accepts an already-created popup window to use. If not specified, the SDK will create its own. This may be useful for platforms like iOS that have security restrictions around when popups can be invoked (e.g. from a user click event)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property timeoutInSeconds

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              timeoutInSeconds?: number;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • The number of seconds to wait for a popup response before throwing a timeout error. Defaults to 60s

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PopupLoginOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PopupLoginOptions extends BaseLoginOptions {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface ProfileFieldPolicy

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface ProfileFieldPolicy {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property access

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                access: 'read_only' | 'read_write';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property reason

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  reason?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property source

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    source: 'user' | 'idp' | 'system';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface PushNotificationAuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface PushNotificationAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      extends AuthenticationMethodWithMetadata {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type: 'push-notification';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          interface PushNotificationEnrollmentChallengeOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          interface PushNotificationEnrollmentChallengeOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type: 'push-notification';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PushNotificationEnrollmentChallengeResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface PushNotificationEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              extends EnrollmentChallengeBaseResponse {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property barcode_uri

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                barcode_uri: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property manual_input_code

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  manual_input_code?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    type: 'push-notification';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface PushNotificationEnrollmentVerifyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface PushNotificationEnrollmentVerifyOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      extends EnrollmentVerifyBaseOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type: 'push-notification';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          interface RecoveryCodeAuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          interface RecoveryCodeAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          extends Omit<AuthenticationMethodWithMetadata, 'name'> {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type: 'recovery-code';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface RecoveryCodeEnrollmentChallengeOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface RecoveryCodeEnrollmentChallengeOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                type: 'recovery-code';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface RecoveryCodeEnrollmentChallengeResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface RecoveryCodeEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  extends EnrollmentChallengeBaseResponse {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property recovery_code

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    recovery_code: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      type: 'recovery-code';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface RecoveryCodeEnrollmentVerifyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface RecoveryCodeEnrollmentVerifyOptions extends EnrollmentVerifyBaseOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          type: 'recovery-code';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface RedirectConnectAccountOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface RedirectConnectAccountOptions<TAppState = any> {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property appState

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            appState?: TAppState;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Optional application state to persist through the transaction.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              await auth0.connectAccountWithRedirect({ connection: 'google-oauth2', appState: { returnTo: '/settings' } });

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property authorization_params

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            authorization_params?: AuthorizationParams;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Additional authorization parameters for the request.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              await auth0.connectAccountWithRedirect({ connection: 'github', authorization_params: { audience: 'https://api.github.com' } });

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property connection

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            connection: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • The name of the connection to link (e.g. 'google-oauth2').

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property openUrl

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            openUrl?: (url: string) => Promise<void>;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Optional function to handle the redirect URL.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              await auth0.connectAccountWithRedirect({ connection: 'google-oauth2', openUrl: async (url) => { myBrowserApi.open(url); } });

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property redirectUri

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            redirectUri?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • The URI to redirect back to after connecting the account.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property scopes

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            scopes?: string[];
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Array of scopes to request from the Identity Provider during the connect account flow.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              await auth0.connectAccountWithRedirect({ connection: 'google-oauth2', scopes: ['https://www.googleapis.com/auth/calendar'] });

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface RedirectLoginOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface RedirectLoginOptions<TAppState = any> extends BaseLoginOptions {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property appState

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            appState?: TAppState;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Used to store state before doing the redirect

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property fragment

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            fragment?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Used to add to the URL fragment before redirecting

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property onRedirect

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            onRedirect?: (url: string) => Promise<void>;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Used to control the redirect and not rely on the SDK to do the actual redirect.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              const client = new Auth0Client({ async onRedirect(url) { window.location.replace(url); } });

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Deprecated

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              since v2.0.1, use openUrl instead.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property openUrl

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            openUrl?: (url: string) => Promise<void> | void;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Used to control the redirect and not rely on the SDK to do the actual redirect.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              const client = new Auth0Client({ openUrl(url) { window.location.replace(url); } });

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example 2

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              import { Browser } from '@capacitor/browser';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              const client = new Auth0Client({ async openUrl(url) { await Browser.open({ url }); } });

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface RedirectLoginResult

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface RedirectLoginResult<TAppState = any> {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property appState

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            appState?: TAppState;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • State stored when the redirect request was made

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property response_type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            response_type: ResponseType.Code;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • The type of response, for login it will be code

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface RefreshTokenOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            interface RefreshTokenOptions extends TokenEndpointOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property refresh_token

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            refresh_token: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface RevokeRefreshTokenOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface RevokeRefreshTokenOptions {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Options for revoking a refresh token

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Tokens & Users

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property audience

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              audience?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Audience to identify which refresh token to revoke. Omit for default audience.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface TokenEndpointOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface TokenEndpointOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property auth0Client

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              auth0Client: any;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property baseUrl

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                baseUrl: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property client_id

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  client_id: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property dpop

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    dpop?: Pick<Dpop, 'generateProof' | 'getNonce' | 'setNonce'>;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property grant_type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      grant_type: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property timeout

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        timeout?: number;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property useFormData

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          useFormData?: boolean;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            index signature

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            [key: string]: any;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface TotpAuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface TotpAuthenticationMethod extends AuthenticationMethodWithMetadata {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                type: 'totp';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface TotpEnrollmentChallengeOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface TotpEnrollmentChallengeOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    type: 'totp';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface TotpEnrollmentChallengeResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface TotpEnrollmentChallengeResponse extends EnrollmentChallengeBaseResponse {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property barcode_uri

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        barcode_uri: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property manual_input_code

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          manual_input_code?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type: 'totp';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface TotpEnrollmentVerifyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              interface TotpEnrollmentVerifyOptions extends EnrollmentVerifyBaseOptions {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property otp_code

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                otp_code: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type: 'totp';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface UpdateAuthenticationMethodRequest

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface UpdateAuthenticationMethodRequest {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property name

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      name?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property preferred_authentication_method

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        preferred_authentication_method?: 'sms' | 'voice';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Only valid when updating a phone authentication method.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface UpdateUserProfileRequest

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        interface UpdateUserProfileRequest {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property family_name

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          family_name?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property given_name

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            given_name?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property name

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              name?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property nickname

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                nickname?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property picture

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  picture?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface UserProfile

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    interface UserProfile {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property created_at

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      created_at?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property email

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        email?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property email_verified

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          email_verified?: boolean;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property family_name

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            family_name?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property given_name

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              given_name?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property name

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                name?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property nickname

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  nickname?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property phone_number

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    phone_number?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      property phone_verified

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      phone_verified?: boolean;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property picture

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        picture?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          property profile_policy

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          profile_policy?: Record<string, ProfileFieldPolicy>;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            property updated_at

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            updated_at?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              property user_id

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              user_id?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                property username

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                username?: string;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface VerifyParams

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface VerifyParams {}
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Parameters for verifying an MFA challenge.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    The grant_type is automatically inferred from which verification field is provided: - otp field → MFA-OTP grant type - oobCode field → MFA-OOB grant type - recoveryCode field → MFA-RECOVERY-CODE grant type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property bindingCode

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  bindingCode?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Binding code (for OOB challenges with binding)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property mfaToken

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  mfaToken: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • MFA token from challenge flow

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property oobCode

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  oobCode?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Out-of-band code (for OOB challenges)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property otp

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  otp?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • One-time password (for OTP challenges)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  property recoveryCode

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  recoveryCode?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Recovery code (for recovery code verification)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface WebAuthnPlatformAuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  interface WebAuthnPlatformAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  extends WebAuthnAuthenticationMethodBase {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    type: 'webauthn-platform';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface WebAuthnRoamingAuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      interface WebAuthnRoamingAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      extends WebAuthnAuthenticationMethodBase {}

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        property type

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type: 'webauthn-roaming';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Enums

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          enum ResponseType

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          enum ResponseType {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Code = 'code',
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          ConnectCode = 'connect_code',
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          • The types of responses expected from the authorization server. - code: used for the standard login flow. - connect_code: used for the connect account flow.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          member Code

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Code = 'code'

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            member ConnectCode

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            ConnectCode = 'connect_code'

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Type Aliases

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type AnonymousGetTokenSilentlyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type AnonymousGetTokenSilentlyOptions = Omit<
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              GetAnonymousAccessTokenOptions,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              'sessionToken'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              >;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Tokens & Users

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type AuthenticationMethod

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type AuthenticationMethod =
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | PasskeyAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | WebAuthnPlatformAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | WebAuthnRoamingAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | PhoneAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | EmailAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | PasswordAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | TotpAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | PushNotificationAuthenticationMethod
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | RecoveryCodeAuthenticationMethod;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                type AuthenticationMethodType

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                type AuthenticationMethodType =
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'passkey'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'password'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'phone'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'totp'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'email'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'push-notification'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'recovery-code'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'webauthn-platform'
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 'webauthn-roaming';

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type AuthenticatorType

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type AuthenticatorType = 'otp' | 'oob' | 'recovery-code';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Supported authenticator types. Note: Email authenticators use 'oob' type with oobChannel: 'email'

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type Cacheable

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type Cacheable = WrappedCacheEntry | KeyManifestEntry;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    type CacheEntry

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    type CacheEntry = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    id_token?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    token_type?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    access_token: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    expires_in: number;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    decodedToken?: DecodedToken;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    audience: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    scope: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    client_id: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    refresh_token?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    oauthTokenScope?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      type CacheKeyData

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      type CacheKeyData = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      audience?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      scope?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      clientId: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type CacheLocation

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type CacheLocation = 'memory' | 'localstorage';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • The possible locations where tokens can be stored

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Configuration

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type ConnectAccountRedirectResult

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type ConnectAccountRedirectResult<TAppState = any> = CompleteResponse & {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * State stored when the redirect request was made
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        appState?: TAppState;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * The type of response, for connect account it will be `connect_code`
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        response_type: ResponseType.ConnectCode;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • The result returned after a successful account connection redirect.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Combines the redirect login result (including any persisted app state) with the complete response from the My Account API.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          TAppState - The type of application state persisted through the transaction.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Example 1

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          const result = await auth0.connectAccountWithRedirect(options); console.log(result.appState); // Access persisted app state console.log(result.connection); // The connection of the account you connected to. console.log(result.response_type === 'connect_code'); // The response type will be 'connect_code'

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Login & Logout

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type CustomFetchMinimalOutput

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type CustomFetchMinimalOutput = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        status: number;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        headers: ResponseHeaders;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Tokens & Users

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type CustomTokenExchangeOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type CustomTokenExchangeOptions = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * The type identifier for the subject token being exchanged
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @pattern
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * - Must be a namespaced URI under your organization's control
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * - Forbidden patterns:
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * - `^urn:ietf:params:oauth:*` (IETF reserved)
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * - `^https:\/\/auth0\.com/*` (Auth0 reserved)
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * - `^urn:auth0:*` (Auth0 reserved)
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @example
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * "urn:acme:legacy-system-token"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * "https://api.yourcompany.com/token-type/v1"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        subject_token_type: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * The opaque token value being exchanged for Auth0 tokens
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @security
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * - Must be validated in Auth0 Actions using strong cryptographic verification
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * - Implement replay attack protection
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * - Recommended validation libraries: `jose`, `jsonwebtoken`
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @example
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        subject_token: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * The target audience for the requested Auth0 token
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @remarks
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * Must match exactly with an API identifier configured in your Auth0 tenant.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * If not provided, falls back to the client's default audience.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @example
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * "https://api.your-service.com/v1"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        audience?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * Space-separated list of OAuth 2.0 scopes being requested
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @remarks
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * Subject to API authorization policies configured in Auth0
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @example
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * "openid profile email read:data write:data"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        scope?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * ID or name of the organization to use when authenticating a user.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * When provided, the user will be authenticated using the organization context.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * The organization ID will be present in the access token payload.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        organization?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * A token representing the acting party for delegation or impersonation scenarios.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @remarks
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * Used when one principal needs to act on behalf of another.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * For example, an AI agent acting on behalf of a user.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @example
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        actor_token?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * The type identifier for the actor token.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @remarks
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * Must be a URI under your organization's control, following the same
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * rules as subject_token_type.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @example
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * "https://idp.example.com/token-type/agent"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        actor_token_type?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * Additional custom parameters for Auth0 Action processing
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @remarks
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * Accessible in Action code via `event.request.body`
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        *
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * @example
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * ```typescript
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * custom_parameter: "session_context",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * device_fingerprint: "a3d8f7...",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        * ```
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        [key: string]: unknown;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • Represents the configuration options required for initiating a Custom Token Exchange request following RFC 8693 specifications.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          See Also

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type EnrollmentChallengeOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        type EnrollmentChallengeOptions =
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | PasskeyEnrollmentChallengeOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | PhoneEnrollmentChallengeOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | EmailEnrollmentChallengeOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | TotpEnrollmentChallengeOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | PushNotificationEnrollmentChallengeOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | RecoveryCodeEnrollmentChallengeOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | PasswordEnrollmentChallengeOptions;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          type EnrollmentChallengeResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          type EnrollmentChallengeResponse =
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | PasskeyEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | PhoneEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | EmailEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | TotpEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | PushNotificationEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | RecoveryCodeEnrollmentChallengeResponse
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | PasswordEnrollmentChallengeResponse;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type EnrollmentResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type EnrollmentResponse = OtpEnrollmentResponse | OobEnrollmentResponse;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • Union type for all enrollment response types

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type EnrollmentVerifyOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            type EnrollmentVerifyOptions =
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | PasskeyEnrollmentVerifyOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | PhoneEnrollmentVerifyOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | EmailEnrollmentVerifyOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | TotpEnrollmentVerifyOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | PushNotificationEnrollmentVerifyOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | RecoveryCodeEnrollmentVerifyOptions
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | PasswordEnrollmentVerifyOptions;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type EnrollParams

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type EnrollParams =
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | EnrollOtpParams
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | EnrollSmsParams
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | EnrollVoiceParams
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | EnrollEmailParams
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | EnrollPushParams;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Union type for all enrollment parameter types

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type FetcherConfig

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type FetcherConfig<TOutput extends CustomFetchMinimalOutput> = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              getAccessToken?: AccessTokenFactory;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              baseUrl?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              fetch?: CustomFetchImpl<TOutput>;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              dpopNonceId?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Tokens & Users

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type FetchOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type FetchOptions = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              method?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              headers?: Record<string, string>;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              credentials?: 'include' | 'omit';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              body?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              signal?: AbortSignal;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type FetchResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type FetchResponse = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              ok: boolean;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              headers: Record<string, string | undefined>;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              json: any;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type GetTokenSilentlyVerboseResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type GetTokenSilentlyVerboseResponse = Omit<TokenEndpointResponse, 'refresh_token'>;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Tokens & Users

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type InteractiveErrorHandler

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type InteractiveErrorHandler = 'popup';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • Configuration option for automatic interactive error handling.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                - 'popup': SDK automatically opens Universal Login popup on MFA error

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Configuration

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type KeyManifestEntry

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              type KeyManifestEntry = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              keys: string[];
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                type MaybePromise

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                type MaybePromise<T> = Promise<T> | T;

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type MfaFactorType

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type MfaFactorType = 'otp' | 'sms' | 'email' | 'push' | 'voice';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Supported MFA factors for enrollment

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type MfaGrantType

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type MfaGrantType = (typeof MfaGrantTypes)[keyof typeof MfaGrantTypes];
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Grant types for MFA verification (derived from MfaGrantTypes constants)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type OobChannel

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type OobChannel = 'sms' | 'voice' | 'auth0' | 'email';
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Out-of-band delivery channels. Includes 'email' which is also delivered out-of-band.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeyGetTokenOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeyGetTokenOptions = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  authSession: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  credential: PublicKeyCredential;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  realm?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  organization?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  scope?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  audience?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  * OTP codes collected for identifier verification. Required when
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  * `PasskeySignupChallenge.verificationRequired` is non-empty. Keys are the
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  * identifier names (e.g. `"email"`, `"phone"`); values are the OTP codes.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  * Omit entirely when no verification is required.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  verification?: {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  email?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  phone?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Options for exchanging a signed passkey credential for tokens.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    credential is the raw PublicKeyCredential produced by the WebAuthn ceremony — a creation credential (signup) or an assertion credential (login). The credential type (attestation vs assertion) is detected automatically during serialization.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeyLoginChallenge

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeyLoginChallenge = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  authSession: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  publicKey: PublicKeyCredentialRequestOptions;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • A passkey login challenge ready for the WebAuthn ceremony.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    publicKey is decoded (base64url → ArrayBuffer) and can be fed directly into a WebAuthn assertion ceremony . authSession must be retained and passed to getTokenWithPasskey().

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeyLoginOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeyLoginOptions = PasskeyLoginChallengeOptions & {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  scope?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  audience?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Options for passkey login (authenticating with an existing passkey).

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeySignupChallenge

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeySignupChallenge = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  authSession: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  publicKey: PublicKeyCredentialCreationOptions;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  /**
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  * Identifiers that require OTP verification before token issuance (e.g. `["email"]`).
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  * Absent when no verification is required. Collect OTP codes for each identifier
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  * and pass them as `verification` to `getTokenWithPasskey()` — do NOT call
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  * `navigator.credentials.create()` until all codes have been collected.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  */
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  verificationRequired?: Array<'email' | 'phone'>;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • A passkey signup challenge ready for the WebAuthn ceremony.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    publicKey is decoded (base64url → ArrayBuffer) and can be fed directly into a WebAuthn credential creation ceremony. authSession must be retained and passed to getTokenWithPasskey().

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeySignupOptions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type PasskeySignupOptions = PasskeySignupChallengeOptions & {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  scope?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  audience?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Options for passkey signup (registering a new user with a passkey).

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type RefreshTokenMode

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type RefreshTokenMode = (typeof RefreshTokenMode)[keyof typeof RefreshTokenMode];
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Configuration

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type TokenEndpointResponse

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type TokenEndpointResponse = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  id_token: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  token_type: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  access_token: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  refresh_token?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  expires_in: number;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  scope?: string;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • Tokens & Users

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type WrappedCacheEntry

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  type WrappedCacheEntry = {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  body: Partial<CacheEntry>;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  expiresAt: number;
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  };

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Package Files (19)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Dependencies (4)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Dev Dependencies (46)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Peer Dependencies (0)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    No peer dependencies.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Badge

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    To add a badge like this onejsDocs.io badgeto your package's README, use the codes available below.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/@auth0/auth0-spa-js.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    • Markdown
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      [![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue)](https://www.jsdocs.io/package/@auth0/auth0-spa-js)
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    • HTML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      <a href="https://www.jsdocs.io/package/@auth0/auth0-spa-js"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>