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

# useAuthenticateWithEmailOrPhone

> Returns a mutation for email or phone authentication.

**useAuthenticateWithEmailOrPhone()**

A mutation hook that handles the entire email or phone authentication flow in a single call — signup or login, verification, session waiting, and wallet creation.

> [!NOTE]
>
> This hook must be paired with `para.onStatePhaseChange()` to handle portal URLs that appear during authentication (verification, passkey, password, PIN). See [Handling State Changes](/v3/react/guides/custom-ui-simplified#handling-state-changes) for the full state listener pattern.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.