> ## Documentation Index
> Fetch the complete documentation index at: https://www.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# useAuthenticatePasskeyMFA

<Card title="Recommended: JavaScript SDK with React Hooks" icon="react" color="#4779FE">
  For new React apps, we recommend the JavaScript SDK with React Hooks (`@dynamic-labs-sdk/react-hooks`) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the [React quickstart (JavaScript SDK)](/docs/javascript/reference/react-quickstart) to get started.
</Card>

### Summary

This hook provides a way for clients to authenticate with MFA using a passkey.

The hook needs to be initialized within a child of [DynamicContextProvider](/docs/react/reference/providers/dynamiccontextprovider).

### Usage

Available methods:

* `authenticatePasskeyMFA`: Authenticate with MFA using a passkey. Optionally accepts a named parameters object: `{ createMfaToken?: boolean, relatedOriginRpId?: string }`.

### Usage

```TypeScript theme={"system"}
import { useAuthenticatePasskeyMFA } from '@dynamic-labs/sdk-react-core';

const App = () => {
  const authenticatePasskeyMFA = useAuthenticatePasskeyMFA();

  return (
    <button
      onClick={() => authenticatePasskeyMFA({
        createMfaToken: true, // Optional, if you want to create a single use MFA token for an action
        relatedOriginRpId: 'example.com', // Optional, if you want to authenticate from a related origin
      })}
    >
      Authenticate with MFA
    </button>
  );
};
```

### Optional parameters

* `relatedOriginRpId` (optional): The Relying Party ID (RP ID) to use when authenticating from a related origin (for example, a sibling subdomain of the domain where the passkey was registered). The canonical form is a **bare hostname** such as `my.example.com`; a full origin like `https://my.example.com` is also accepted and resolves to the same RP ID. It must match the `rpId` the credential was registered under. See [Related Origin Requests](https://passkeys.dev/docs/advanced/related-origins/) for how sibling origins are authorized.