> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-docs-event-stream-action-templates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# MfaVoiceChallenge
> Describes all the hooks and methods available to customize the Universal Login `mfa-voice-challenge` screen.
The `mfa-voice-challenge` screen prompts the user to enter a one-time code delivered via voice call to complete MFA verification.
## 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 to include only the code you need for your specific use case.
* Using root import allows you to load all screens from a single bundle, which is useful when you want a unified build to handle all possible screens.
```jsx Import Example theme={null}
// root import
import { useMfaVoiceChallenge } from '@auth0/auth0-acul-react';
// partial import
import {
useMfaVoiceChallenge,
// Context hooks
useUser,
useTenant,
useBranding,
useClient,
useOrganization,
usePrompt,
useScreen,
useTransaction,
useUntrustedData,
// Common hooks
useCurrentScreen,
useAuth0Themes,
useErrors,
// Utility hooks
useChangeLanguage,
useResend,
// Methods
continueMethod,
pickPhone,
resendCode,
switchToSms,
tryAnotherMethod,
} from "@auth0/auth0-acul-react/mfa-voice-challenge";
function MfaVoiceChallengeScreen() {
const { continueMethod } = useMfaVoiceChallenge();
return (
);
}
```
## Context Hooks
Screen-scoped hooks that provide read-only access to Auth0 context data on the `mfa-voice-challenge` screen. Import them from `@auth0/auth0-acul-react/mfa-voice-challenge`.
() => BrandingMembers}>
This hook provides branding configurations, such as logo, colors, and theme settings displayed on the `mfa-voice-challenge` screen.
```jsx Example theme={null}
import { useBranding } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function CustomTheme() {
const branding = useBranding();
}
```
() => ClientMembers}>
This hook provides client-related configurations, such as `id`, `name`, and `logoUrl`, for the `mfa-voice-challenge` screen.
```jsx Example theme={null}
import { useClient } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function AppInfo() {
const client = useClient();
}
```
() => OrganizationMembers}>
This hook provides information about the user's Organization if the MFA flow is Organization scoped. Returns `null` when no Organization context is present.
```jsx Example theme={null}
import { useOrganization } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function OrgSelector() {
const organization = useOrganization();
if (!organization) {
return
No organization context
;
}
}
```
() => PromptMembers}>
This hook contains data about the current prompt in the authentication flow.
```jsx Example theme={null}
import { usePrompt } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function FlowInfo() {
const prompt = usePrompt();
}
```
() => ScreenMembersOnMfaVoiceChallenge}>
This hook contains details specific to the `mfa-voice-challenge` screen, including its configuration and context.
```jsx Example theme={null}
import { useScreen } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function ScreenDebug() {
const screen = useScreen();
}
```
() => TenantMembers}>
This hook contains data related to the tenant, such as `id` and associated metadata.
```jsx Example theme={null}
import { useTenant } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function TenantInfo() {
const tenant = useTenant();
}
```
() => TransactionMembers}>
This hook provides transaction-specific data for the `mfa-voice-challenge` screen, such as the current MFA flow state.
```jsx Example theme={null}
import { useTransaction } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function TransactionInfo() {
const transaction = useTransaction();
}
```
() => UntrustedDataMembersOnMfaVoiceChallenge}>
This hook handles untrusted data passed to the screen, such as prefilled values from URL parameters.
```jsx Example theme={null}
import { useUntrustedData } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function PrefilledForm() {
const untrustedData = useUntrustedData();
}
```
() => UserMembers}>
This hook provides details of the active user, including `username`, `email`, and available authentication methods.
```jsx Example theme={null}
import { useUser } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function UserProfile() {
const user = useUser();
}
```
MfaVoiceChallengeMembers}>
This hook returns all methods and context available on the `mfa-voice-challenge` screen.
## Methods
This method submits the voice call one-time code to complete the MFA challenge.
```jsx Example theme={null}
import { useMfaVoiceChallenge } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function VerifyCodeForm() {
const { continueMethod } = useMfaVoiceChallenge();
return (
);
}
```
**Method Parameters**
[MfaVoiceChallengeContinueOptions](/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/MfaVoiceChallengeContinueOptions).
The verification code received via voice call.
Optional flag to remember the device for 30 days, skipping future MFA challenges.
This method navigates to the phone number selection screen.
```jsx Example theme={null}
import { useMfaVoiceChallenge } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function PickPhoneButton() {
const { pickPhone } = useMfaVoiceChallenge();
return (
);
}
```
This method resends the voice call one-time code to the user's phone.
```jsx Example theme={null}
import { useMfaVoiceChallenge } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function ResendCodeButton() {
const { resendCode } = useMfaVoiceChallenge();
return (
);
}
```
This method switches the MFA challenge to SMS delivery instead of a voice call.
```jsx Example theme={null}
import { useMfaVoiceChallenge } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function SwitchToSmsButton() {
const { switchToSms } = useMfaVoiceChallenge();
return (
);
}
```
This method navigates to the MFA method selection screen so the user can choose a different authentication factor.
```jsx Example theme={null}
import { useMfaVoiceChallenge } from '@auth0/auth0-acul-react/mfa-voice-challenge';
function TryAnotherMethodButton() {
const { tryAnotherMethod } = useMfaVoiceChallenge();
return (
);
}
```
## Common/Utility Hooks
useResend} type="Hooks">
This hook manages resend cooldown state and logic for screens with resend code functionality.
useAuth0Themes} type="Hooks">
This hook gets the current theme options with flattened configuration from branding context.
useChangeLanguage} type="Hooks">
This hook returns a function for changing the display language on the current ACUL screen.
useCurrentScreen} type="Hooks">
This hook gets the current screen context and state.
useErrors} type="Hooks">
This hook reads and manages server, client, and developer errors on the screen.
## 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 to include only the code you need for your specific use case.
* Using root import allows you to load all screens from a single bundle, which is useful when you want a unified build to handle all possible screens.
```jsx Import Example theme={null}
// root import
import { useMfaVoiceChallenge } from '@auth0/auth0-acul-react';
// partial import
import {
useMfaVoiceChallenge,
// Context hooks
useUser,
useTenant,
useBranding,
useClient,
useOrganization,
usePrompt,
useScreen,
useTransaction,
useUntrustedData,
// Common hooks
useCurrentScreen,
useAuth0Themes,
useErrors,
// Utility hooks
useChangeLanguage,
useResend,
// Methods
continueMethod,
pickPhone,
resendCode,
switchToSms,
tryAnotherMethod,
} from "@auth0/auth0-acul-react/mfa-voice-challenge";
function MfaVoiceChallengeScreen() {
const { continueMethod } = useMfaVoiceChallenge();
return (
);
}
```
## Context Hooks
Screen-scoped hooks that provide read-only access to Auth0 context data on the `mfa-voice-challenge` screen. Import them from `@auth0/auth0-acul-react/mfa-voice-challenge`.