Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Reset User Password Azure AD activity

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

VariableDescription
user_idThe object ID (GUID) or the user principal name of the target user. An example of a user principal name is someuser@a830edad9050849NDA1.onmicrosoft.com.
passwordUser'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_passwordControl that requires the user to change their password at the next login, if set to true.

Output variables

VariableDescription
errorReturns the error string from the REST message. If there are no errors, this variable returns a null value.
bodyContains a string value representing the output from the REST message.
status_codeContains the status code returned from the Web service.

Conditions

ConditionDescription
SuccessActivity reset the named user's password.
FailureActivity failed to reset the named user's password, or the activity failed to connect to Azure AD.

Parent Topic:Azure AD activity pack