Skip to main content
The mfa-recovery-code-challenge-new-code screen displays a new recovery code to the user after successful authentication, prompting them to save it securely.
MfaRecoveryCodeChallengeNewCode

Import

Each screen has its own set of hooks and methods. The SDK supports partial import and root import for each screen.
  • Using partial import allows you include only the code you need for your specific use case.
  • Using root import allows you to load all screens from a single bundle useful when you want a unified build to handle all possible screens.
Import Example
// root import
import { useMfaRecoveryCodeChallengeNewCode } from '@auth0/auth0-acul-react';

// partial import
import {
  useMfaRecoveryCodeChallengeNewCode,
  // Context hooks
  useUser,
  useTenant,
  useBranding,
  useClient,
  useOrganization,
  usePrompt,
  useScreen,
  useTransaction,
  useUntrustedData,
  // Common hooks
  useCurrentScreen,
  useAuth0Themes,
  useErrors,
  // Utility hooks
  useChangeLanguage,
  // Methods
  continueMethod,
} from "@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code";

function MfaRecoveryCodeChallengeNewCodeScreen() {
  const { continueMethod } = useMfaRecoveryCodeChallengeNewCode();
  return (
    <button onClick={() => continueMethod()}>
      I've Saved My Code
    </button>
  );
}

Context Hooks

Screen-scoped hooks that provide read-only access to Auth0 context data on the mfa-recovery-code-challenge-new-code screen. Import them from @auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code.
useBranding
This hook provides branding configurations, such as logo, colors, and theme settings displayed on the mfa-recovery-code-challenge-new-code screen.
Example
import { useBranding } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function CustomTheme() {
  const branding = useBranding();
}
useClient
This hook provides client-related configurations, such as id, name, and logoUrl, for the mfa-recovery-code-challenge-new-code screen.
Example
import { useClient } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function AppInfo() {
  const client = useClient();
}
useOrganization
This hook provides information about the user’s Organization if the MFA flow is Organization scoped. Returns null when no Organization context is present.
Example
import { useOrganization } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function OrgSelector() {
  const organization = useOrganization();
  if (!organization) {
    return <p>No organization context</p>;
  }
}
usePrompt
This hook contains data about the current prompt in the authentication flow.
Example
import { usePrompt } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function FlowInfo() {
  const prompt = usePrompt();
}
This hook contains details specific to the mfa-recovery-code-challenge-new-code screen, including its configuration and context.
Example
import { useScreen } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function ScreenDebug() {
  const screen = useScreen();
}
useTenant
This hook contains data related to the tenant, such as id and associated metadata.
Example
import { useTenant } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function TenantInfo() {
  const tenant = useTenant();
}
useTransaction
This hook provides transaction-specific data for the mfa-recovery-code-challenge-new-code screen, such as the current MFA flow state.
Example
import { useTransaction } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function TransactionInfo() {
  const transaction = useTransaction();
}
useUntrustedData
This hook handles untrusted data passed to the screen, such as prefilled values from URL parameters.
Example
import { useUntrustedData } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function PrefilledForm() {
  const untrustedData = useUntrustedData();
}
useUser
This hook provides details of the active user, including username, email, and available authentication methods.
Example
import { useUser } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';
function UserProfile() {
  const user = useUser();
}
useMfaRecoveryCodeChallengeNewCode
This hook returns all methods and context available on the mfa-recovery-code-challenge-new-code screen.

Methods

continueMethod
void | Promise<void>
This method confirms that the user has saved their new recovery code and continues the authentication flow.
Example
import { useMfaRecoveryCodeChallengeNewCode } from '@auth0/auth0-acul-react/mfa-recovery-code-challenge-new-code';

function ContinueButton() {
  const { continueMethod } = useMfaRecoveryCodeChallengeNewCode();
  return (
    <button onClick={() => continueMethod()}>
      I've Saved My Code
    </button>
  );
}

Common/Utility Hooks

This hook gets the current theme options with flattened configuration from branding context.
This hook returns a function for changing the display language on the current ACUL screen.
This hook gets the current screen context and state.
This hook reads and manages server, client, and developer errors on the screen.