Description:

This step creates the Azure Entra ID user. 

The Create User workflow step creates a new user account in Microsoft Entra ID (formerly Azure Active Directory) using the configured Microsoft Entra ID connection.

The step provisions a user account by supplying the required user information, including username, first name, last name, and email address.

The step supports:

• Microsoft Entra ID user provisioning
• Configurable Entra ID connections
• Dynamic user information using workflow variables
• Automated identity provisioning
• Integration with Microsoft Graph through FlowWright connections

This step can be used for:

• Employee onboarding
• Contractor account creation
• Automated user provisioning
• HR system integration
• Identity lifecycle automation
• Self-service account creation
• Business process automation

Usage:

The Create User step is typically placed after employee information has been collected or approved within a workflow.

The workflow can dynamically populate the user properties using workflow variables, form fields, HR systems, or data retrieved from external applications.

Once the user account has been created, later workflow steps can:

• Assign Microsoft 365 licenses
• Add the user to security groups
• Assign application roles
• Send welcome emails
• Create additional cloud resources
• Continue the employee onboarding process

You need to set up an EntraID connection. Go to Integration > Connections > Generic Connections. On the Manage Generic Connections page, click Actions > Create. A sample connection is included here for reference. 

Example:

Let’s build and execute the “clsCreateEntraIDUserDef” example:

• Create a new process definition named “clsCreateEntraIDUserDef” and open it in designer mode. 
• Drag an “clsCreateEntraIDUser” step to the canvas.
• Connect the dots between the “Start” and “clsCreateEntraIDUser” steps.
• Click the "clsCreateEntraIDUser" step to configure its "Required" properties. Provide a name for the step. Select the EntraID connection from the drop-down list. Enter the "Username, First Name, Last Name, and Email address”. Click the Save button. Note: Click the "AI Predict" button to have the Copilot add new process steps that match your process description. 

• The “Logging” configuration is necessary for documentation and also measures workflow progress and percent complete. This is achieved by configuring the step state and percent fields individually, as shown below. Configure the “Logging” using the following properties.

• Save the Process Definition. Create a new Process Instance and execute it. When the workflow reaches the Create User step, FlowWright connects to the configured Microsoft Entra ID tenant and attempts to create the user account using the supplied information. If the account is created successfully, the workflow follows the Created return path. If the account cannot be created—for example, because the username already exists or the connection is unavailable—the workflow follows the NotCreated return path.

Tips:

• Verify that the Microsoft Entra ID connection has been configured before using this step.
• Use workflow variables to dynamically populate user information.
• Ensure that usernames (User Principal Names) are unique within the tenant.
• Validate email addresses before attempting to create the account.
• Use the Created and NotCreated return paths to implement appropriate success and error handling.
• Combine this step with license assignment and group membership steps to automate the complete onboarding process.

Notes:

• A valid Microsoft Entra ID connection must exist before this step can execute.
• The configured connection must have sufficient Microsoft Graph permissions to create user accounts.
• Duplicate usernames or invalid user information may cause the operation to fail.
• Network connectivity or authentication issues may prevent successful user creation.
• The workflow should include appropriate error handling for the NotCreated return path.

Definition Sample:

You may download the sample definition(s) from the link provided and later import them into your FlowWright Process Definition (XML file) or Form Definition (HTML file) page.

Note: Verify and complete any missing configuration after importing the sample, including:

• Microsoft Entra ID connection
• User information mappings
• Workflow variable mappings
• Microsoft Graph permissions
• Environment-specific settings

After verifying the configuration, save the Process Definition before execution.

You may download the sample definition(s) from the link provided and later import them (drag-and-drop) into your FlowWright Process Definition (XML file) or Form Definition (HTML file) page. 

Click here to download the sample file.