> For the complete documentation index, see [llms.txt](/llms.txt).

# Sign in a user

Use the `useWeb3AuthConnect` hook to authenticate a user. Call `connectTo` with an `AUTH_CONNECTION` constant and any additional parameters required by the chosen provider.

## Import[​](#import "Direct link to Import")

```
import { useWeb3AuthConnect, AUTH_CONNECTION } from '@web3auth/react-native-sdk'

```

## Usage[​](#usage "Direct link to Usage")

- Social login
- Email passwordless
- Custom JWT

```
import { useWeb3AuthConnect, AUTH_CONNECTION } from '@web3auth/react-native-sdk'

function LoginView() {
  const { connectTo, loading, error } = useWeb3AuthConnect()

  return (
    <View>
      <Button
        title={loading ? 'Signing in…' : 'Sign in with Google'}
        disabled={loading}
        onPress={() => connectTo({ authConnection: AUTH_CONNECTION.GOOGLE })}
      />
      <Button
        title="Sign in with Apple"
        disabled={loading}
        onPress={() => connectTo({ authConnection: AUTH_CONNECTION.APPLE })}
      />
      {error && <Text style={{ color: 'red' }}>{error.message}</Text>}
    </View>
  )
}

```

```
import { useWeb3AuthConnect, AUTH_CONNECTION } from '@web3auth/react-native-sdk'

function EmailLoginView() {
  const { connectTo, loading } = useWeb3AuthConnect()
  const [email, setEmail] = useState('')

  return (
    <View>
      <TextInput
        value={email}
        onChangeText={setEmail}
        placeholder="Enter your email"
        keyboardType="email-address"
        autoCapitalize="none"
      />
      <Button
        title={loading ? 'Sending link…' : 'Continue with email'}
        disabled={loading || !email}
        onPress={() =>
          connectTo({
            authConnection: AUTH_CONNECTION.EMAIL_PASSWORDLESS,
            extraLoginOptions: { login_hint: email },
          })
        }
      />
    </View>
  )
}

```

```
import { useWeb3AuthConnect, AUTH_CONNECTION } from '@web3auth/react-native-sdk'

function JwtLoginView() {
  const { connectTo, loading } = useWeb3AuthConnect()

  const loginWithFirebase = async () => {
    // Obtain the idToken from your own authentication flow (Firebase, Auth0, etc.)
    const idToken = await getFirebaseIdToken()

    await connectTo({
      authConnection: AUTH_CONNECTION.CUSTOM,
      authConnectionId: 'w3a-firebase-demo', // Dashboard Connection ID
      idToken,
      extraLoginOptions: { verifierIdField: 'sub' },
    })
  }

  return <Button title="Sign in with Firebase" disabled={loading} onPress={loginWithFirebase} />
}

```

## Parameters[​](#parameters "Direct link to Parameters")

- Parameters
- Interface
- AUTH_CONNECTION enum

| Parameter                | Required | Description                                                                                                                                                                                                                        |
| ------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| authConnection           | Yes      | Authentication method. Pass an AUTH_CONNECTION.* constant. Replaces the v8 loginProvider field.                                                                                                                                    |
| authConnectionId?        | No       | Dashboard Connection ID for the auth connection. Required when using AUTH_CONNECTION.CUSTOM or when you have multiple connections of the same type and need to target one specifically. Replaces the v8 loginConfig[key].verifier. |
| groupedAuthConnectionId? | No       | Dashboard Grouped Connection ID when using grouped (aggregate) connections. Connections sharing the same groupedAuthConnectionId produce the same wallet address. Replaces the v8 loginConfig[key].verifierSubIdentifier.          |
| idToken?                 | No       | A JWT issued by your authentication provider (Firebase, Auth0, Cognito, and so on). Pass this when using AUTH_CONNECTION.CUSTOM. The token is sent directly to the SDK instead of opening a browser redirect.                      |
| extraLoginOptions?       | No       | Additional OAuth hints passed to the authentication provider. Common fields: login_hint (email), domain (Auth0 domain), verifierIdField (JWT claim to use as the wallet identifier).                                               |
| redirectUrl?             | No       | Override the global redirectUrl from web3AuthOptions for this login call only.                                                                                                                                                     |
| mfaLevel?                | No       | Override the global mfaLevel for this login call only.                                                                                                                                                                             |
| curve?                   | No       | Elliptic curve to use for key generation. Accepts SUPPORTED_KEY_CURVES.SECP256K1 (EVM) or SUPPORTED_KEY_CURVES.ED25519 (Solana). Defaults to the chain namespace.                                                                  |
| sessionTime?             | No       | Override the global session duration (in seconds) for this login session only.                                                                                                                                                     |
| dappShare?               | No       | Custom device share key for MFA-enabled wallets. Required when reconstructing a key with a custom share.                                                                                                                           |
| appState?                | No       | Arbitrary state string that is returned in the redirect callback. Useful for restoring application state after the OAuth redirect.                                                                                                 |

```
export interface SdkLoginParams {
  /** Authentication method: use AUTH_CONNECTION.* constants */
  authConnection: AUTH_CONNECTION_TYPE
  /** Dashboard Connection ID; required for AUTH_CONNECTION.CUSTOM */
  authConnectionId?: string
  /** Grouped Connection ID for aggregate verifier flows */
  groupedAuthConnectionId?: string
  /** JWT from your auth provider for custom authentication */
  idToken?: string
  /** Additional OAuth parameters (login_hint, domain, verifierIdField, etc.) */
  extraLoginOptions?: ExtraLoginOptions
  /** Override redirectUrl for this login call */
  redirectUrl?: string
  /** Override MFA level for this login call */
  mfaLevel?: MfaLevelType
  /** Elliptic curve for key generation */
  curve?: SUPPORTED_KEY_CURVES_TYPE
  /** Override session duration for this session */
  sessionTime?: number
  /** Custom device share for MFA-enabled wallets */
  dappShare?: string
  /** Arbitrary app state to restore after redirect */
  appState?: string
}

```

`AUTH_CONNECTION` replaces the v8 `LOGIN_PROVIDER` enum. Import it from `@web3auth/react-native-sdk`.

| AUTH_CONNECTION constant           | Description                                               | v8 LOGIN_PROVIDER equivalent      |
| ---------------------------------- | --------------------------------------------------------- | --------------------------------- |
| AUTH_CONNECTION.GOOGLE             | Google OAuth 2.0                                          | LOGIN_PROVIDER.GOOGLE             |
| AUTH_CONNECTION.FACEBOOK           | Facebook OAuth                                            | LOGIN_PROVIDER.FACEBOOK           |
| AUTH_CONNECTION.APPLE              | Sign in with Apple                                        | LOGIN_PROVIDER.APPLE              |
| AUTH_CONNECTION.DISCORD            | Discord OAuth                                             | LOGIN_PROVIDER.DISCORD            |
| AUTH_CONNECTION.TWITTER            | Twitter / X OAuth                                         | LOGIN_PROVIDER.TWITTER            |
| AUTH_CONNECTION.GITHUB             | GitHub OAuth                                              | LOGIN_PROVIDER.GITHUB             |
| AUTH_CONNECTION.TWITCH             | Twitch OAuth                                              | LOGIN_PROVIDER.TWITCH             |
| AUTH_CONNECTION.LINE               | LINE OAuth                                                | LOGIN_PROVIDER.LINE               |
| AUTH_CONNECTION.KAKAO              | Kakao OAuth                                               | LOGIN_PROVIDER.KAKAO              |
| AUTH_CONNECTION.LINKEDIN           | LinkedIn OAuth                                            | LOGIN_PROVIDER.LINKEDIN           |
| AUTH_CONNECTION.WEIBO              | Weibo OAuth                                               | LOGIN_PROVIDER.WEIBO              |
| AUTH_CONNECTION.WECHAT             | WeChat OAuth                                              | LOGIN_PROVIDER.WECHAT             |
| AUTH_CONNECTION.EMAIL_PASSWORDLESS | Magic link / OTP sent to an email address                 | LOGIN_PROVIDER.EMAIL_PASSWORDLESS |
| AUTH_CONNECTION.SMS_PASSWORDLESS   | OTP sent to a phone number                                | LOGIN_PROVIDER.SMS_PASSWORDLESS   |
| AUTH_CONNECTION.FARCASTER          | Farcaster protocol sign-in                                | ,                                 |
| AUTH_CONNECTION.CUSTOM             | Any custom JWT flow (Firebase, Auth0, Cognito, and so on) | LOGIN_PROVIDER.JWT                |

## Related[​](#related "Direct link to Related")

- [useWeb3AuthConnect hook reference](/embedded-wallets/sdk/react-native/hooks/useWeb3AuthConnect/)
- [Custom authentication guide](/embedded-wallets/sdk/react-native/advanced/custom-authentication/)