The Get User Info activity returns the named user's information from the Azure Active Directory.

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. Check If User Exists 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
Note: Version 2 of this activity enforces input validation. If empty, the following message appears: "Mandatory input 'user_id' is empty"
.

Output variables

Table 2. Check If User Exists 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.
user_info The user_info array contains attributes that can be leveraged by other activities as inputs. For example, the user objectid output (GUID) can be passed to the Add User to Group activity as the user_id input.
  • objectid: User's Azure AD identifier.
  • accountEnabled: Boolean variable indicating whether the user's account is active or inactive.
  • displayName: Users display name, such as jacinto.gawron.
  • userPrincipalName: User's name in email format, such as jacinto.gawron@wammo.com.
  • mailNickname: User's email alias.

Conditions

Table 3. Check If User Exists conditions
Condition Description
User exists Activity found the named user.
User does not exist Activity was unable to find the named user in the customer tenant domain.
Failure Activity failed to connect to Azure AD.