Sign in

v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-01970424.3 KB
OTP

Send sign-in code

Send a code to the user's email address for sign-in.

post/auth/otp/send-sign-in-code

Request body

emailstring required

The email to sign in with.

callback_urlstring required

The base callback URL to construct the magic link from. A query parameter code with the verification code will be appended to it. The page should then make a request to the /auth/otp/sign-in endpoint.

bot_challenge_tokenstring
bot_challenge_phase'invisible' | 'visible'
bot_challenge_unavailable'true'

Example request

{
  "email": "johndoe@example.com",
  "callback_url": "https://example.com/handler/magic-link-callback"
}

Response

Successful response

noncestring required

A token that must be stored temporarily and provided when verifying the 6-digit code

Example response

{
  "nonce": "u3h6gn4w24pqc8ya679inrhjwh1rybth6a7thurqhnpf2"
}