Skip to main content
function useVerifyMfaModal(options: UseVerifyMfaModalOptions): UseVerifyMfaModalReturn;
Hook to imperatively control the MFA verification modal. This hook allows you to open and close the MFA verification modal programmatically, which is useful for integrating MFA verification into complex flows without using the <VerifyMfaModal /> component pattern.

​
Parameters

ParameterTypeDescription
optionsUseVerifyMfaModalOptionsThe options for the hook including callbacks.

​
Returns

UseVerifyMfaModalReturn An object containing open and close functions.

​
Example

function ProtectedAction() {
  const { open } = useVerifyMfaModal({
    onSuccess: () => performSensitiveAction(),
    onError: (error) => console.error("MFA verification failed:", error),
    onCancel: () => console.log("MFA verification cancelled"),
  });

  const handleClick = () => {
    const opened = open(); // Returns false if modal is already open
    if (!opened) {
      console.log("MFA modal is already open");
    }
  };

  return (
    <button onClick={handleClick}>
      Perform sensitive action
    </button>
  );
}