Microsoft Intune

Integrating Microsoft Intune with Hudu allows you to automatically sync device information from Intune into your Hudu documentation portal.

Before setting up the Microsoft Intune integration,we recommend reviewing our Understanding Integrations article for foundational concepts and helpful tips.

What You'll Need

To set up the Microsoft Intune integration, ensure you have:

Admin or Super Admin access in Hudu.
Global Administrator or Intune Administrator access in Azure.
An active Microsoft Intune license and a configured tenant.
Access to the client’s Microsoft Intune tenant.

Integration Features

This integration automatically pulls key device metadata from Microsoft Intune into Hudu, helping you centralize IT documentation and streamline support. The synced information includes:

Model
Manufacturer
Device Ownership
Operating System
Registration Date
Last Sign In Date

You can use Connected Fields to map information from this integration into Hudu custom fields. This allows data to appear in list views and be fully searchable across your account. Learn more →

What Hudu needs from Microsoft Intune

Application (client) ID.
Directory (tenant) ID.
Client Secret Value.

Guides

The Microsoft Intune integration is currently only available to be pulled in for a single tenant at a time.

Enabling the Integration

The Microsoft Intune integration can be enabled at any point during your Hudu environment testing and/or during production. Integrations can be merged into your existing documentation based on set rules; providing the ability to start with integration setup, or easily connect them at a later date.

Obtaining the Microsoft Intune Information

Step 1: Register an Application in Azure

Go to the Azure Portal and sign in.
Navigate to Azure Active Directory > App registrations > New registration.
Fill out the form:
Name: Give your app a meaningful name.
Supported account types: Choose Accounts in this organizational directory only.
Leave the Redirect URI empty.
Click Register.
Save the Application (client) ID and Directory (tenant) ID for later.

Step 2: Assign API Permissions

After registering, go to the app’s API permissions section.
Click Add a permission > Microsoft Graph > Application permissions.
Add the following permissions:
- Device.Read.All
- User.Read.All
- Group.Read.All
- Directory.Read.All
Click Grant Admin Consent to authorize these permissions.

Step 3: Create a Client Secret

Go to Certificates & secrets > New client secret.
Add a description (e.g., Hudu API Key ) and choose an expiration period.
Click Add.
Copy the value immediately — it will not be shown again.

Setting up the Integration in Hudu

Navigate to Admin > Integrations in Hudu.
Select Microsoft Intune.
Enter your:
- Tenant ID
- Client ID
- Client Secret
Choose to only sync managed devices from Intune. If this setting is unchecked, the integration will also sync in devices from Entra.
Click Save Settings.
Click Test Connection.

Make sure to test the integration for a successful connection before continuing. Do not continue until you see a "Connection Successful" message.
Initiate a sync to import device data.

If you don't see/have not created any asset layouts yet, you’ll need to create these. Visit Asset Layouts for additional information!

Once you have started a sync, you should make sure that company is properly matched (you can always unmatch cards that were matched incorrectly) before proceeding to other companies.

FAQ

Common Error: Test connection unsuccessful

Answer: If you receive the above error, or receive an error when clicking "Test Connection", this either means:

- One (or multiple) of your credentials is incorrect. Verify that you correctly copied the Application ID, Directory ID, and Client Secret Value.
- You haven't granted Admin access to the correct permissions. Verify that you have added the correct permissions to your App, as well as clicked Grant Admin Access.
- Save your settings again, click refresh, and test for a successful connection again.