Skip to content
Esc
navigateopen⌘Jpreview
Dashboard

Start passwordless sign in/up

Start sign in/up process with passwordless

POST/{apiBasePath}/{tenantId}/signinup/code
Path parameters
apiBasePathstringrequired
Its value depends on the apiBasePath set by the user
tenantIdstring
The tenant against which the request is made. If left empty, the default tenant will be used.
Header parameters
ridstring
The passwordless recipe ID
Request body
application/json
One of:
object
emailemailrequired
Email address
shouldTryLinkingWithSessionUserboolean
object
phoneNumberphoneNumberrequired
Phone number
shouldTryLinkingWithSessionUserboolean
Responses
200Started the passwordless sign in/up process.
One of:
object
statusstatusOK
Success status indicator
Allowed:OK
deviceIddeviceId
This should be saved on the starting device to enable the manual code entry flow.
preAuthSessionIdpreAuthSessionId
An identifier that used to identify the login attempt/device.
flowTypestring
Allowed:MAGIC_LINKUSER_INPUT_CODE_AND_MAGIC_LINKUSER_INPUT_CODE
object
statusstring
Allowed:SIGN_IN_UP_NOT_ALLOWED
reasonstring
generalErrorResponse
statusstring
Error status code
Allowed:GENERAL_ERROR
messagestring
Error message
403A claim validation error happened during factor setup
One of:
object
messagestring
Error message
claimValidationErrorsobject[]
List of claim validation errors
Show properties
Array of object
idstring
The claim ID
reasonobject
The reason for the validation error
object
messagestring
Error message
claimValidationErrorsobject[]
List of claim validation errors
Show properties
Array of object
idstring
The claim ID
reasonstring
The reason for the validation error
404Resource not found error
string
500Internal server error
string
Try it
Server
Parameters
Bodyapplication/json
Request
curl -X POST "/auth/public/signinup/code" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "[email protected]",
  "shouldTryLinkingWithSessionUser": false
}'
Response
{
  "status": "OK",
  "deviceId": "TU/52WOcktSv99zqaAZuWJG9BSoS0aRLfCbep8rFEwk=",
  "preAuthSessionId": "kFmkPQEAJtACiT2w/K8fndEuNm+XozJXSZSlWEr+iGs=",
  "flowType": "MAGIC_LINK"
}

API reference

API schema and response details