Initiate Auth

Start any authentication flow in one unified endpoint. This endpoint supports all authentication methods including SMS, email, OAuth, passkey, and SIWE (Sign-In with Ethereum).

Supported Methods:

• SMS - Send verification code to phone number
• Email - Send verification code to email address
• Passkey - Generate WebAuthn challenge for biometric authentication
• SIWE - Generate Sign-In with Ethereum payload

Flow:

1. Choose your authentication method
2. Provide method-specific parameters
3. Receive challenge data to complete authentication
4. Use the /complete endpoint to finish the process

OAuth:

The OAuth method uses a dedicated /auth/social endpoint instead of this one:

GET /auth/social?provider=google&redirectUrl=...

Custom (JWT, auth-payload) and Guest:

For custom authentication (JWT, auth-payload) and for guest authentication, you can skip this step and use the /auth/complete endpoint directly.

Authentication: Requires x-client-id header for frontend usage or x-secret-key for backend usage.