The Reset User Password activity changes the named user's Azure Active Directory password.

The Azure password policy imposes constraints on the complexity, length, and re-use of a password.

To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Azure AD. This activity was built with the REST web service activity template.

Important: The REST message used for this activity must be configured to use OAuth 2.0.

Input variables

Table 1. Reset User Password input variables
Variable Description
user_id The object ID (GUID) or the user principal name of the target user. An example of a user principal name is someuser@a830edad9050849NDA1.onmicrosoft.com.
password User's Azure AD password. This password must be passed as a workflow input with a type of Password (2 Way Encrypted) and must meet the password policy set in Azure AD.
change_password Control that requires the user to change their password at the next login, if set to true.

Output variables

Table 2. Reset User Password output variables
Variable Description
error Returns the error string from the REST message. If there are no errors, this variable returns a null value.
body Contains a string value representing the output from the REST message.
status_code Contains the status code returned from the Web service.

Conditions

Table 3. Reset User Password conditions
Condition Description
Success Activity reset the named user's password.
Failure Activity failed to reset the named user's password, or the activity failed to connect to Azure AD.