Validate a user's email address using the JWT token sent via email.
This is a self-service endpoint for users to confirm their email address as part of the sign-up process.
When a user registers and email validation is enabled (authUser.skipEmailValidation=false),
they receive an email containing a validation link with a signed JWT token.
The user (or a client application) then calls this endpoint with that token to complete validation.
This endpoint:
Verifies the JWT signature and checks expiry
Extracts the unique ID from the JWT subject
Sets the user's validated status to true
Resets the unique ID token (invalidating the link)
Grants default entitlements to the user
Important: This is a single-use token. Once the email is validated, the token is invalidated.
Any subsequent attempts to use the same token will return a 404 error (UserNotFoundByToken or UserAlreadyValidated).
The token is a signed JWT with a configurable expiry (default: 1440 minutes / 24 hours).
The server-side expiry can be configured with the email_validation_token_expiry_minutes property.
For administrative validation (without an email token), see the Validate a User endpoint (PUT /management/users/USER_ID).
User Authentication is Optional. The User need not be logged in.