cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

API to Configure Sign In Page Fields

API to Configure Sign In Page Fields

A customer might need to configure the labels on the Identity Security Cloud sign in page. For example, customers who use email addresses for user names might find that their users get confused by the User Name field.

 

This functionality also allows you to provide sample text in the empty fields when the user clicks out of them.

Prerequisites:

  • Open your preferred tool for making API calls and have admin access for authentication. (Postman will be shown in the screenshots below)

 

NOTE: The API endpoint used to change the Sign In Fields is currently an Experimental endpoint. You will need to click the X-Sailpoint-Experimental header in Postman to send this call.

 

Change the Sign In Fields

1. Open the API endpoint PUT /ui-metadata/tenant

2. In Headers, click the box to enable the X-Sailpoint-Experimental true field

3. In the box, there should be 3 fields you can specify values for. Either "null" them, or add the values you wish: iFrameWhiteList, usernameLabel, usernameEmptyText.

Sign In 1.png

4. Send the call and give it up to 5 minutes to see the change in your tenant UI.

Sign In 2.png

Reset the Sign In Page:

1. To reset the Sign in Page to the default, make the same PUT /ui-metadata/tenant call, but set the values for the fields to null.

Sign In 3.png

Labels (1)
Version history
Revision #:
9 of 9
Last update:
‎Jun 19, 2026 11:44 AM
Updated by: