Sign in
Auth

Request registration magic link

Creates a pending email verification and sends magic link email via Postmark. When EMAIL_VERIFICATION_REQUIRED is disabled, auto-verifies and returns a Firebase custom token.

post/v1/auth/magic-link/request

Headers

originstring required
accept-languagestring required

Request body

emailstring required
firebaseUidstring
redirectPathstring

Relative path to redirect the user to after email confirmation

localestring

UI locale for the email copy (bare code or BCP-47); falls back to Accept-Language, then English

Example request

{
  "email": "user@example.com",
  "firebaseUid": "firebase-uid-123",
  "redirectPath": "/chat/abc-123",
  "locale": "de"
}

Response

Magic link sent (empty body) or email auto-verified (body with firebaseCustomToken)

firebaseCustomTokenstring

Present when email verification is disabled — use to sign in directly

firebaseUidstring

Changes

No recorded changes to this endpoint across all 1 revision of this API.