Creating workflows for Microsoft Intune users

Let Oomnitza be your single source of truth!

You'll get visibility of your users as data from Microsoft Intune is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Microsoft Intune in minutes

You'll get visibility of your Microsoft Intune users by creating configurable workflows to automate tasks such as:

• • Onboarding and offboarding users.
  • Creating and adjusting users as part of a user change or user onboarding workflow
  • Retrieving detailed user information, including the user’s contact information, location, and role

Contents

1. Before you start
2. Creating workflows
3. Create user workflows
   1. Microsoft Intune Get User by User ID
   2. Microsoft Intune Update User
   3. Microsoft Intune Delete User
   4. Microsoft Intune Create User

Before you start

Before you can create the integration with Oomnitza, you need to have completed the following steps:

1. Generated your OAuth2.0 credentials in Azure
2. Added your OAuth 2.0 credentials to Oomnitza
3. Created an extended integration for Microsoft Intune users. 

Creating workflows

Create user workflows

To create a user workflow, you must complete these steps:  

1. Click Configuration > Workflows 
2. Click Add (+) and select People from the list.
3. Edit the Begin Block and add rules to trigger the workflow. For example, if you set the Actions to Schedule and add a rule so that the Email Equals <EmployeeEmail> you can trigger a workflow to fetch a user matching a certain name on a specific date. Refer to Using the Begin block. 
4. Drag and drop the API block onto the Sandbox.
5. Click Edit on the API block and enter Microsoft Intune in the search field. 
6. Select a preset from the list below. To choose a preset, click the forward arrow (>).
   
   • Microsoft Intune Get User by User ID
   • Microsoft Intune Update User
   • Microsoft Intune Delete User
   • Microsoft Intune Create User
7. Select the credentials that you created in Adding your Microsoft credentials to Oomnitza.
8. Enter any mandatory information when prompted.
9. Select Advanced Mode.
10. Select the Information or Body tab. Review and ensure that the properties referenced in these locations, such as {{microsoft_intune_user_id}}, exist in Oomnitza and are populated with information before you run this workflow. You can create a user integration to retrieve this information before you run this workflow.
11. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. Once you have the entire response, you can then parse the JSON response values to custom Oomnitza fields, as per the example below.
12. Connect the Blocks. 
13. Save, validate, and activate your workflow.

Fig: Mapping the Update User response

Using the Microsoft Intune Get User by User ID preset

The Microsoft Intune Get User Details preset gets the details of a specified user. The user to be retrieved is referenced in the Advanced Mode > Information tab in the property{{microsoft_intune_user_id}}.

This preset requires the DeviceManagementManagedDevices.Read.Allor DeviceManagementManagedDevices.ReadWrite.Allpermissions.

For further information, see Microsoft Graph API Documentation: Get User. 

Using the Microsoft Intune Update User preset

The Microsoft Intune Update User preset updates a specified user. You need to supply the following information to update a user:

• Display Name
• Job Title
• Mobile Phone

The user to be retrieved is referenced in the Advanced Mode > Information tab in the property{{microsoft_intune_user_id}}.

This preset requires theDeviceManagementManagedDevices.ReadWrite.Allpermissions.

For further information, see Microsoft Graph API Documentation: Update User. 

Using the Microsoft Intune Delete User preset

The Microsoft Intune Delete User preset deletes the specified user.

The user to be retrieved is referenced in the Advanced Mode > Information tab in the property{{microsoft_intune_user_id}}.

This preset requires theDeviceManagementManagedDevices.ReadWrite.Allpermissions.

For further information, see Microsoft Graph API Documentation: Delete User. 

Warning
If successful, this workflow returns a204 No Contentresponse code. Do not map a response in Advanced Mode > Response, as it will cause the content to fail due to no content.

Using the Microsoft Intune Create User preset

The Microsoft Intune Create User preset creates a user. You need to supply the following information to create a user:

• Display Name
• Username
• Email
• User Principal Name
• Temporary Password

This preset requires theDeviceManagementManagedDevices.ReadWrite.Allpermissions.

For further information, see Microsoft Graph API Documentation: Create user. 

Reference articles for workflows

• Mapping positive and negative responses
• Troubleshooting workflows 
• Using the API block