Update to emailAddr does not update the username

Last update: 2023-11-07
  • Created for:
  • Developer


Normally, emailAddr and username are the same attribute. Therefore, if you change a user’s emailAddr attribute, the username attribute is automatically updated to match.

When the username does not match the emailAddr, an update to the emailAddr does not update the username automatically. This is true for both emailAddr changes through the user interface and through the API.


The mismatch may be created in several ways:

  • Users created before the synchronization rule existed. Very old user accounts may not have these attributes in sync.

  • Users created via SSO at a time when the emailAddr in Workfront was case-sensitive. The SSO auto-provision option would run a case-sensitive check for users based on the attributes of the user from the identity provider. When an exact match did not exist, the auto-provision services would create a new user. If a user already existed, there was a potential that the username and emailAddr would not have the same casing.

  • Users that have had the username attribute updated directly via the API, and their emailAddr was not updated. The username and emailAddr possibly do not match.


Use the API to change the username attribute to be the same as the emailAddr. After synchronizing the attributes, any update to the emailAddr will also update the username to match (when the username field is not included in the update).

On this page