Sign in with email OTP

POST

/signin/otp/email

• Nhost Authentication API Server

Initiate email-based one-time password authentication. Sends an OTP to the specified email address. If the user doesn’t exist, a new account will be created with the provided options.

Request Body ^required

Email address and optional user options for OTP authentication

object

email

required

A valid email

string format: email

Example

john.smith@nhost.io

options

object

allowedRoles

Array<string>

Example

[
  "me",
  "user"
]

defaultRole

string

Example

user

displayName

string

<= 32 characters /^[\p{L}\p{N}\p{S} ,.'-]+$/

Example

John Smith

locale

A two or three characters locale

string

>= 2 characters <= 3 characters

Example

en

metadata

object

key

additional properties

any

Example

{
  "firstName": "John",
  "lastName": "Smith"
}

redirectTo

string format: uri

Example

https://my-app.com/catch-redirection

Responses

200

OTP sent to user’s email successfully

string

Allowed values: OK

default

An error occurred while processing the request

Standardized error response

object

status

required

HTTP status error code

integer

Example

400

message

required

Human-friendly error message

string

Example

Invalid email format

error

required

Error code identifying the specific application error

string

Allowed values: default-role-must-be-in-allowed-roles disabled-endpoint disabled-user email-already-in-use email-already-verified forbidden-anonymous internal-server-error invalid-email-password invalid-request locale-not-allowed password-too-short password-in-hibp-database redirectTo-not-allowed role-not-allowed signup-disabled unverified-user user-not-anonymous invalid-pat invalid-refresh-token invalid-ticket disabled-mfa-totp no-totp-secret invalid-totp mfa-type-not-found totp-already-active invalid-state oauth-token-echange-failed oauth-profile-fetch-failed oauth-provider-error invalid-otp cannot-send-sms provider-account-already-linked