Create User Azure AD activity
The Create User activity creates a user for the Azure Active Directory tenant.
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
| Variable | Description |
|---|---|
| display_name | Name of the Azure AD user in the accepted display format, such as jacinto.gawron. |
| user_principal_name | User principal name (UPN) in an email format. For example, you might enter jacinto.gawron@khitomer.com. |
| mail_nickname | User's email alias that redirects to the user's full address. |
| 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. |
| account_enabled | Control that sets the user's account is enabled, if set to true. |
| given_name | First name of the user. |
| surname | Last name of the user. |
| other_mails | List of additional email addresses for the user. For example, you might enter ["jac@home.com", "jgawron@fabrikam.com"]. |
| country | The country or region in which the user is located. For example, you might enter US or UK. The default value is set toUS. |
| city | City in which the user is located. |
| department | Name of the department in which the user works. |
| mobile | User's primary cell phone number. |
| job_title | User's job title. |
| physical_delivery_office_name | Office location in the user place of business. |
| postal_code | Postal code of the user's address. |
| preferred_language | Language in which the user prefers to communicate. This value must follow the ISO 639-1 Code. For example, you might enter en-US. The default value is set to en-US. |
| state | State or province for the user's address. |
| street_address | Street address of the user's place of business. |
| telephone_number | Primary telephone number of the user's place of business. |
| usage_location | Two letter country code that is required for users who are assigned Office 365 licenses. The default value is US. |
Output variables
| Variable | Description |
|---|---|
| error | Returns the error string from the REST message. If there are no errors, this variable returns a null value. |
| status\_code | Contains the status code returned from the Web service. |
| user\_exists | Output variable mapped to the JSON message that contains the `User already exists` error. |
| 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
| Conditions | Description |
|---|---|
| Created user | Activity successfully created the user. |
| User already exists | User already exists in the tenant domain. |
| Failure | Activity failed to connect to Azure AD, or an input value was invalid. |