> ## 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.

# useAuthenticateWithOAuth

> Returns a mutation for standard OAuth authentication.

**useAuthenticateWithOAuth()**

A mutation hook that handles the entire OAuth authentication flow in a single call — OAuth redirect/popup, verification, session waiting, and wallet creation. Supports Google, Apple, Discord, X, Facebook, Telegram, and Farcaster.

> [!NOTE]
>
> This hook must be paired with `para.onStatePhaseChange()` to handle portal URLs that appear after OAuth completes (e.g. passkey or password setup for returning users). 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.