Customize Forgot Password Wizard
Last Updated:
Overview
When using the Universal Login form and selecting Forgot Password, the form prompts the user to enter a username. This occurs when the Require Username setting is enabled in the Database connection settings. This article describes how to customize the Change Password Wizard to ask for an email address or username.
Applies To
- Forgot Password
- Change Wizard Password
- Universal Login
- Management API
Solution
-
Send a PUT request to the following Management API endpoint:
https://<auth0_domain>/api/v2/prompts/reset-password/custom-text/en -
Include the script in the body. Example script:
{
"reset-password-request":{
"descriptionUsername":"Enter your email address and we will send you instructions to reset your password",
"placeholderUsername":"Email Address"
}
}
NOTE: The endpoint accepts a PUT request, which overrides the previous configuration.
- To avoid unwanted changes, run a GET request to the same endpoint to capture the current configuration and include all screens that contain an update in the body of your PUT request.