The Nerdio Manager for MSP integration with Hudu brings your clients' Microsoft environments into Hudu, syncing Nerdio accounts as companies along with their Intune-managed devices and Microsoft 365 users. Because Nerdio Manager manages all of your client tenants from one place, a single Nerdio integration covers every client account at once, so there is no need to set up a separate integration for each Microsoft tenant.
Before setting up your Nerdio integration, read our Understanding Integrations article to learn basic concepts and useful tips.
What you'll need
- A Nerdio Manager for MSP installation with MSP-level access
- A Microsoft Entra ID administrator who can grant admin consent for the Nerdio REST API client
- Admin or super-admin user role within Hudu
At any time, you can come back to your Hudu admin area → Integrations → Nerdio Manager for MSP → Settings to make changes to the integration.
Integration features
Hudu's integration with Nerdio Manager for MSP allows you to sync:
- Accounts into Hudu
- Each Nerdio client account can be matched to an existing Hudu company, or used to create a new company in Hudu.
- Devices into Hudu
- Intune-managed devices for each matched account, including manufacturer, model, operating system, OS version, compliance state, and last sync time. Mobile devices enrolled in Intune are included.
- Users into Hudu
- Microsoft 365 users for each matched account.
- Detailed device information (optional)
- Serial number, IP addresses, storage, and TPM/BIOS details for each device.
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. Visit Connected Fields for additional information.
What Hudu needs from Nerdio
- Fully qualified domain name (your Nerdio Manager URL)
- Tenant ID
- Client ID
- Client secret
- Scope
Nerdio Manager for MSP is installed in your own Azure subscription, so the fully qualified domain name is unique to your installation. This is the same URL you use to sign in to Nerdio Manager (for example, https://web-admin-portal-xxxxxx.azurewebsites.net).
Enabling the Nerdio REST API
- In Nerdio Manager, navigate to:
System → System Settings → Integrations → REST API - Follow the Nerdio wizard to enable the REST API. Nerdio creates the client application for you, so you do not need to build an app registration in Entra ID manually.
- When prompted, sign in to Azure with an Entra ID administrator account and grant admin consent.
- Return to Nerdio Manager and copy the tenant ID, client ID, scope, and client secret. Store the client secret securely, as it will be needed in Hudu.
Visit Nerdio's Nerdio Manager Partner API - Getting Started article for additional information on enabling the REST API.
Enabling the Nerdio integration
- Integrations can be enabled at any time, during Hudu environment testing or in production.
- Once enabled, integrations can be matched to existing documentation based on predefined rules.
- This allows you to configure the integration upfront or connect it later as needed.
- To enable the Nerdio integration:
- Navigate to the Hudu admin area (Admin → Integrations).
- Select Nerdio Manager for MSP from the list.
- Open the Settings tab.
Setting up the integration in Hudu
Step 1. Enter your Nerdio credentials
- In the Nerdio Manager for MSP Credentials section, enter the fully qualified domain name (your Nerdio Manager URL, including https://).
- Enter the tenant ID.
- Enter the client ID.
- Enter the client secret.
- Once saved, the secret is hidden. To change it later, click the edit icon next to the field.
- Enter the scope.
- The scope is specific to your Nerdio installation and ends in
/.default. Copy it exactly as shown in Nerdio Manager.
- The scope is specific to your Nerdio installation and ends in
- Click Save Credentials.
- A Credentials saved message displays, prompting you to test the connection to continue setup.
Step 2. Test connection
- At the top right of the integration page, click Test Connection.
- If the connection is successful, a Connection successful message displays and the Activate and Sync button becomes clickable.
- The Options section also appears on the Settings tab once the connection is successful.
- If the connection is not successful, you will receive an error and will not be able to continue the setup. Review the credentials entered in Step 1, click Save Credentials, and test the connection again.
Step 3. Activate and sync
- Click Activate and Sync to run the initial sync. This begins pulling over your Nerdio accounts so they can be matched in Hudu.
- The integration status changes to Syncing, and the Activate and Sync button is replaced by Sync Now and Pause Integration.
Sync time varies depending on the amount of data. You can navigate away from the page while a sync is in progress and check the Logs tab for status updates.
Step 4. Choose your options
- In the Options section, select any of the following:
- Auto-update names of assets - Automatically syncs asset names from Nerdio to keep them current in Hudu.
- Match assets on primary serial - Assets will only be matched if both the asset name and primary serial number match. Requires Sync detailed device information.
- Sync detailed device information - Adds serial numbers, IP addresses, and storage details for each device.
- Do not update basic company details - Prevents company details in Hudu from being changed when they are changed in Nerdio.
- Under Skip the following, select any data you do not want imported:
- Devices
- Users
- Click Save Options.
- Click Sync Now. Once the sync completes, the Companies section appears on the Settings tab.
Step 5. Match Nerdio accounts
- Before data from Nerdio can be brought into Hudu, accounts must be matched to:
- Existing companies in Hudu, or
- New companies you create in Hudu
- Devices and users are only synced for matched accounts.
- Hudu recommends matching one account first for testing to ensure data imports correctly.
- On the Settings tab, scroll to the Companies section.
- Open the Unmatched tab. Use the All match types, Suggested matches, and No suggested matches filters to narrow the list. Suggested matches are shown in the Match column.
- Select the accounts you want to match, then use the Bulk actions menu to choose one of the following:
- Bulk accept/create for all - Accepts suggested matches and creates new Hudu companies for the rest
- Change match - Matches the account to a different existing Hudu company
- Delete matches - Removes the match
- Accounts left unmatched, and their data, will not be imported.
- Matched accounts move to the Matched tab.
Step 6. Sync your data
- Click Sync Now to pull over data for the matched or newly created companies.
- Re-sync any time changes are made to account matching.
- Cards are not created yet; they are created once default asset layouts are set and the integration is synced again.
- You can review sync progress and any warnings on the Logs tab.
Step 7. Select default asset layouts
- In the Asset Layouts section, select a default asset layout for Devices and for Users.
- All Nerdio devices sync to the single default Devices asset layout.
- Only active asset layouts are available to select.
- Click Save Asset Layouts.
Changes to default asset layouts only apply to new data that has not already been synced into Hudu.
If you don't see/have not created any asset layouts yet, you'll need to create these. Visit Asset Layouts for additional information.
Step 8. Sync now to complete setup
- Click Sync Now to create cards in the selected asset layouts.
- Synced records appear on the Cards tab, showing each asset name, asset layout, company, and card ID.
- The top of the integration page shows the number of matched companies, unmatched companies, and synced cards, along with the next scheduled run.
Connected fields
Connected fields let you map data points from Nerdio Manager for MSP into custom fields on your asset layouts. Connected fields fill automatically and update on each sync, so the data appears in list views and is fully searchable across your account.
- Navigate to the Hudu admin area (Admin → Asset Layouts).
- Open an asset layout that Nerdio Manager for MSP syncs to (the default Devices or Users asset layout).
- Edit the field you want to connect, select Nerdio Manager for MSP as the source, and choose the data point to fill the field with.
- Save the field and the asset layout.
- Return to the Nerdio Manager for MSP integration and click Sync Now to fill the connected fields.
Fields can only be connected to Nerdio Manager for MSP if the asset layout is a sync location for the integration. Connected fields are not bidirectional, so changes made in Hudu will not sync back to Nerdio Manager for MSP.
Visit Connected Fields for additional information on mapping integration data to asset fields.
FAQ
The Activate and Sync button only becomes clickable after a successful Test Connection. Confirm your credentials are entered correctly, click Save Credentials, and then click Test Connection again.
Confirm the asset layout is a sync location for Nerdio Manager for MSP (the default Devices or Users asset layout) and that the field is set to a Nerdio Manager for MSP data point, then click Sync Now. If the value is empty in Nerdio Manager for MSP, it will also be empty in Hudu.
The Intune and Office 365 integrations each connect to a single Microsoft tenant, so an MSP needs a separate integration for every client. The Nerdio integration connects once to Nerdio Manager and covers every client account managed there.
No. Any Nerdio Manager for MSP administrator with MSP-level access can enable the REST API. You will also need an Entra ID administrator to grant admin consent. The separate Nerdio Distributor API is not required.
Verify that the fully qualified domain name, tenant ID, client ID, client secret, and scope match exactly what is shown in Nerdio Manager, and that admin consent was granted in Azure. Also confirm that your Nerdio Manager installation is running in Azure. Click Save Credentials and retry Test Connection.
Devices and users are only synced for matched accounts. Confirm the account is on the Matched tab in the Companies section, that Devices or Users is not checked under Skip the following in the Options section, and that default asset layouts are selected in the Asset Layouts section. Then click Sync Now.
Serial numbers, IP addresses, and other hardware details are only synced when Sync detailed device information is enabled in the Options section. Enable the option, click Save Options, and re-sync. Match assets on primary serial also requires this option.
Not every Microsoft 365 user has a primary email address set. When one is missing, Hudu uses the user's other email addresses, and then their user principal name (sign-in name).
Not currently. The integration syncs accounts, Intune devices, and Microsoft 365 users.
Native integrations automatically re-sync every 3 hours. The next scheduled run is shown at the top of the integration page. You can also click Sync Now, or use the global re-sync feature, to refresh the integration at any point.
Device data is provided through Nerdio's beta API, which Nerdio may change without notice. If device syncing stops working unexpectedly, please contact our support team at support@hudu.com.