Password Reset Page Edit

Hi All,
I am trying to edit the content on the Password Reset Page using the “Create Custom Password Instructions” API.

First I tried the GET method and then using the CREATE the method, I tried to edit the contents of the page, but there was no change on the UI side.
Again I tried to use the DELETE method first to delete the contents and then tried to create again.

So all these are working on the API side and giving 200 status code, but there are no changes on the UI side even during the DELETE method or CREATE method.

Is there some other way to go about this.

Thanks All.

This is likely due to the pageId you’re using. The custom instructions only apply to specific pages, so if the pageId doesn’t match the correct stage in the password reset flow, nothing will change on the UI.

Try something like this:

{
    "pageId": "change-password:enter-password",
    "pageContent": "See company password policies for details by clicking <a href=\"url\">here</a>"
}

At first, I tried using GET method and it asks for “pageId” as well, and if the “pageId” is wrong it throws error, so I tried using multiple “pageIds” and found the right one by trial and error and it gave 200 status code. So I tried using that exact “pageId” in both DELETE and POST methods as well.

One common issue is unescaped characters in the payload. If you haven’t already, try escaping the characters using a tool like this freeformatter escape and then use the escaped data in your payload.

To determine which value to use for the flow e.g. change-password:enter-password, reset-password:finish, etc. you can observe the URL in your browser when going through the flow manually. That usually gives a good hint about the expected value. Based on that, choose the appropriate one from the list:

[change-password:enter-password, change-password:finish, flow-selection:select, forget-username:user-email, mfa:enter-code, mfa:enter-kba, mfa:select, reset-password:enter-password, reset-password:enter-username, reset-password:finish, unlock-account:enter-username, unlock-account:finish]

As for when to show content on the page . You can match that with the values listed above to determine which screen to render.

Hope that helps!

Using the URL, I found the right PageID. But still there are no changes in the UI. There are no changes even after the Delete operation is triggered

You can use the POST operation with the following sample payload to set custom password instructions:

  1. Reset password:
{
  "pageId": "reset-password:enter-password",
  "pageContent": "To ensure your account remains secure, please follow our company password policy when setting your new password. Your password must meet the required complexity rules and should not be reused from previous passwords. For full details, please review the <a href=\"https://yourcompany.com/password-policy\" target=\"_blank\">Password Policy Guidelines</a>. If you have any questions or issues, contact IT Support."
}
  1. Change password:
{
    "pageId": "change-password:enter-password",
    "pageContent": "To ensure your account remains secure, please follow our company password policy when setting your new password. Your password must meet the required complexity rules and should not be reused from previous passwords. For full details, please review the <a href=\"https://yourcompany.com/password-policy\" target=\"_blank\">Password Policy Guidelines</a>. If you have any questions or issues, contact IT Support."
}

Also, make sure you’re applying this to the correct tenant. If you have access to multiple tenants (e.g., dev vs prod), you might be calling the API on one but checking the UI in another.

I included a HTML tag

TEXT

and added the text inside the tag and it worked for me.

Thank you for your kind help.

This topic was automatically closed 60 days after the last reply. New replies are no longer allowed.