The Hudu and Snipe-IT integration automatically syncs asset, user, and location data from Snipe-IT into Hudu, helping keep asset inventories and infrastructure documentation accurate, organized, and up to date.
Visit Understanding Integrations for additional information on integration concepts and useful tips before getting started.
What you'll need
- Your Snipe-IT URL.
- A Snipe-IT API token, generated by a user with API access.
- Admin or super-admin user role within Hudu.
At any time, you can come back to your Hudu admin area → Integrations → Snipe-IT → Settings to make changes to the integration.
Integration features
Hudu's integration with Snipe-IT allows you to sync:
- Companies into Hudu
- Match Snipe-IT companies to existing Hudu companies, or create new companies in Hudu from them.
- Assets into Hudu
- Hardware assets from Snipe-IT, placed into a default asset layout or sent to specific asset layouts by category using sort rules.
- Users into Hudu
- Snipe-IT users for each matched company.
- Locations into Hudu
- Snipe-IT locations for each matched company.
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 Snipe-IT
- Snipe-IT URL
- API token
Enabling the Snipe-IT 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 Snipe-IT integration:
- Navigate to the Hudu admin area (Admin → Integrations).
- Select Snipe-IT from the list.
- Open the Settings tab.
Setting up the integration in Hudu
Step 1. Enter your Snipe-IT credentials
- In the Snipe-IT Credentials section, enter your Snipe-IT URL (for example, https://snipe-it.yourdomain.com).
- Enter your API token.
- Once saved, the token is hidden. To change it later, click the edit icon next to the field.
- 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 Snipe-IT companies 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 - If a name is changed in Snipe-IT, the name will automatically be updated in Hudu.
- Match assets on primary serial - Assets will only be matched if both the asset name and primary serial number match.
- Under Skip the following, select any data you do not want imported:
- Assets
- Users
- Locations
- Click Save Options.
- Once the integration is activated and your options are saved, the Device Types section appears on the Settings tab.
Step 5. Choose which device types to sync
- In the Device Types section, under Skip the following asset categories, select any Snipe-IT asset categories you do not want imported (for example, Desktops, Displays, Laptops, Mobile Phones, Tablets, or VOIP Phones).
- Skipped categories will not be synced.
- Click Save Device Types.
- Click Sync Now. Once the sync completes, the Companies section appears on the Settings tab.
Step 6. Match Snipe-IT companies
- Before data from Snipe-IT can be brought into Hudu, companies must be matched to:
- Existing companies in Hudu, or
- New companies you create in Hudu
- Hudu recommends matching one company 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, or the search bar, to narrow the list. Suggested matches are shown in the Match column when a Hudu company with a matching name is found.
- Use the row actions menu (…) on a company, or select multiple companies and 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 company to a different existing Hudu company
- Delete matches - Removes the match
- Companies left unmatched, and their data, will not be imported.
- Matched companies move to the Matched tab.
Step 7. 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 company 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 8. Select default asset layouts and sort rules
- In the Asset Layouts section, select a default asset layout for each synced category: Assets, Users, and Locations.
- Only active asset layouts are available to select.
- To send specific asset categories to their own asset layouts, click Add Sort Rule:
- Under When type is, select the Snipe-IT asset category (for example, Desktops).
- Under Place in, select the asset layout, or click Or, create a new asset layout for this type.
- Any asset category without a sort rule is placed in the default Assets layout.
- Click Save Asset Layouts.
Changes to default asset layouts and sort rules 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 9. 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 Snipe-IT 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 Snipe-IT syncs to (a default asset layout or a sort rule destination).
- Edit the field you want to connect, select Snipe-IT as the source, and choose the data point to fill the field with.
- Save the field and the asset layout.
- Return to the Snipe-IT integration and click Sync Now to fill the connected fields.
Fields can only be connected to Snipe-IT 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 Snipe-IT.
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 Snipe-IT (a default asset layout or a sort rule destination) and that the field is set to a Snipe-IT data point, then click Sync Now. If the value is empty in Snipe-IT, it will also be empty in Hudu.
Native integrations will automatically re-sync (update) 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.
API tokens are generated from within your Snipe-IT instance by a user with API access. Refer to Snipe-IT's own documentation for the exact steps in your version.
No. The Snipe-IT integration currently syncs companies, hardware assets, users, and locations.
Data only syncs for matched companies, so confirm the company is on the Matched tab in the Companies section. Then check that Assets is not checked under Skip the following in the Options section, that the asset's category is not checked in the Device Types section, and that default asset layouts are selected in the Asset Layouts section. Save any changes and click Sync Now.
Verify your Snipe-IT URL and API token are correct and that the token belongs to a user with API access. Click Save Credentials, then try testing the connection again.
It should appear on subsequent re-syncs. If it is still not appearing, check the Cards tab with Include archived cards selected to make sure it has not been archived, and confirm its category still exists in your sort rules.