Please note: If you are looking to setup an integration with Pulseway PSA, you will need to follow the Kaseya BMS integration guide (found here).
What You'll Need
- Access to retrieve Pulseway RMM API credentials.
- Admin or super-admin user role within Hudu.
At any time, you can come back to your Hudu admin area Integrations → Pulseway RMM to make changes to the integration.
Integration Features
-
Companies.
- Create client spaces within Hudu directly from Pulseway companies, or seamlessly merge them into existing (already-created) client spaces.
-
Systems.
- Pull system information from Pulseway; sorted into asset layouts based on set sort rules and your primary sync location(s).
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 Pulseway RMM
- Pulseway Server Hostname.
- Token ID.
- Token Secret.
Obtaining the Pulseway RMM Information
-
Pulseway Server Hostname: This corresponds to your subdomain and domain.
- Example: company.pulseway.com
- Token ID: On the left-hand sidebar, navigate to Administration >> Configuration >> API Access. Select Create Token from the top-right.
- Configure the token settings:
- Name the token and a description (optional)
- Choose the token validity dates
- Choose to whitelist IP addresses
- Determine the access (All Companies or Select Organizations)
- Add the following permissions:
- Copy the generated Token ID and Token Secret.
Enabling the Pulseway RMM 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 Pulseway RMM integration:
Navigate to the Hudu admin area (Admin → Integrations).
Select Pulseway RMM from the list.
Setting up the Integration in Hudu
Step 1. Connect to Pulseway RMM
- Enter Pulseway credentials
- Pulseway Server Hostname
- Token ID
- Token Secret
-
Select Default Asset Layouts
Choose an asset layout (must be active asset layout) from the list to designate as the default asset layout.
This layout will store information that is pulled in but not explicitly mapped to another asset layout.
-
The Pulseway RMM integration requires one default asset layout for:
- Pulseway Systems
If you don't see/have not created any asset layouts yet, you’ll need to create these. Visit Asset layouts for additional information!
Select any additional options:
- Auto-update names of Assets - If name is changed in Pulseway RMM, 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 Pulseway RMM.
- Skip Importing Systems - This will skip importing any systems from Pulseway RMM into Hudu. If systems have already been imported and then this option is selected, no new systems will be synced in.
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 Pulseway RMM companies.
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 Companies
-
Before companies from Pulseway RMM 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:
Companies from Pulseway RMM are imported
They appear in the Matched Companies List for the integration
Navigate to Hudu Admin → Integrations → Pulseway RMM
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 Pulseway RMM company
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 data will fill
-
Add Sort Rules
Sort Rules determine how data types from Pulseway RMM 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.
Save your settings and Stop and Start the integration to start bringing in data.
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 Pulseway 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 Pulseway are communicating correctly.
- Verify your Pulseway 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.