v15

latestOpenAPI 3.0.0MIT Licenseraw.githubusercontent.com2026-08-016088119.5 KB
user

Change user email

Request to change the authenticated user's email address. A verification email will be sent to the new address to confirm the change. Requires elevated permissions.

post/user/email/change

Request body

newEmailstring email required

A valid email

codeChallengestring

PKCE code challenge (S256). When provided, the verification redirect will contain an authorization code instead of a refresh token.

Example request

{
  "newEmail": "john.smith@nhost.io",
  "options": {
    "redirectTo": "https://my-app.com/catch-redirection"
  }
}

Response

Email change requested. An email with a verification link has been sent to the new address

'OK' required