What You'll Need
- Access to retrieve Watchman Monitoring API credentials
- Admin or super-admin user role within Hudu
Integration Features
-
Organizations
- Create client spaces within Hudu directly from Watchman organizations, or seamlessly merge them into existing (already-created) client spaces
-
Computers
- Pull computer information from Watchman; sorted into asset layouts based on your set sort rules
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 Watchman Monitoring
- Watchman Subdomain
- API Key.
Enabling the Integration
Integrations can be enabled at any time, during Hudu environment testing or in production
Once enabled, integrations can be merged into existing documentation based on predefined rules
This allows you to configure the integration upfront or connect it later as needed
-
To enable the Watchman integration:
Navigate to the Hudu admin area (Admin → Integrations)
Select Watchman Monitoring from the list
Obtaining the Watchman Monitoring Information
- Navigate and log in to your Watchman Monitoring account
- On the left-hand sidebar, find Settings → API
- Click Generate a Key
- Name the key and ensure that full access is enabled
Setting up the Integration in Hudu
Step 1. Connect to Watchman
You will need to add information so we can connect to Watchman.
- Enter your Watchman credentials
- Subdomain
- if you are test.monitoringclient.com, then use test
- API Key
- Subdomain
- Select any additional options:
- Auto-update names of Assets - If name is changed in Watchman, the name will automatically be updated in Hudu
- Do not update basic company details - This will prevent the company details from being changed in Hudu if they are changed in Watchman
- Match assets on primary serial - This option tells Watchman to match devices using their primary serial number. It helps ensure that assets are correctly identified and reduces the chance of duplicates when device names or other attributes change
Step 2. Test Connection and Run an Initial Sync
- On the integration overview page, click Test Connection
- If successful, start an initial sync to bring in Watchman groups
Make sure to test the integration for a successful connection before continuing; do not continue on until you see a connection successful message display.
Step 3. Match Groups
-
Before groups from Watchman can be brought into Hudu, they must be matched to:
Existing companies in Hudu, or
New companies you create in Hudu
Hudu recommends matching one client first for testing to ensure data imports correctly
-
When the integration runs successfully for the first time:
Clients from Watchman are imported
They appear in the Matched Companies List for the integration
Navigate to Hudu Admin → Integrations → Watchman
Open the integration and click Match Companies
-
Review the list of companies and choose one of the following options:
Bulk create and/or match all companies
Match a company to an existing Hudu company
Create a new matched company in Hudu from a Watchman group
Leave a company unmatched (it and its data will not be imported)
After matching companies, re-run the integration import to populate data for the matched or newly created companies
Step 4. Choose Where Watchman Data will Fill to
-
Add Sort Rules
Sort Rules determine how data types from Watchman are mapped to asset layouts in Hudu
They let you define specific rules that control where each asset type is placed
Any asset types imported without an assigned Sort Rule will automatically be placed into the default asset layout
Asset layouts used for Sort Rules can be created ahead of time in the Hudu admin area (Admin → Asset Layouts) and must be marked as Active
You can also create new asset layouts directly from this section if needed
If you don't see/have not created any asset layouts yet, you’ll need to create these. Visit Asset layouts for additional information!
FAQ
Answer: Native integrations will automatically re-sync (update) every 3 hours.
You can also use either the global or the card-specific re-sync features to refresh native integration syncs at any point.
Answer: If the Watchman Monitoring sync has been loading for a significant amount of time (it can take up to 10 minutes), follow the steps below:
-
- Test the connection to ensure Hudu and Watchman Monitoring are communicating correctly
- Verify your Watchman Monitoring credentials
- Refresh the page (while a sync is actively running)
- Stop the sync and restart the sync
Answer: It should appear on subsequent re-syncs. If it is still not appearing, ensure that it has not been archived; and still exists in your sort rules.
Notes: Active integrations sync automatically every 3 hours; manual re-syncs can be performed either within an integrations’ settings page or by clicking the top right re-sync button.