Skip to content

Send verification email

POST
/user/email/send-verification-email

Send an email verification link to the specified email address. Used to verify email addresses for new accounts or email changes.

Email address and optional redirect URL for verification email

object
email
required

A valid email

string format: email
Example
john.smith@nhost.io
options
object
redirectTo
string format: uri
Example
https://my-app.com/catch-redirection

Email verification email sent successfully

string
Allowed values: OK

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