Domotz

What You'll Need

• Access to retrieve Domotz API credentials.
• Admin or super-admin user role within Hudu.

Integration Features

• Agents.
  • A full inventory of the network is provided by Domotz and sent to Hudu.
• Devices.
  • Devices identified by Domotz are then sorted into asset layouts based on set sort rules.

What Hudu needs from Domotz

• API Key Endpoint.
• API Key.

Obtaining the Domotz Information

• Navigate to your Domotz instance >> Account Settings>> Domotz API.
• Click Create an API key.

• Copy the API key endpoint and the API key and paste them into Hudu exactly.
• Save the settings.

• Start the sync. After inputting all settings and ensuring the connection was successful; start the sync to push initial data to Hudu from Domotz (this is required before moving on).

Enabling the Domotz 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 Domotz integration:

  • Navigate to the Hudu admin area (Admin → Integrations).

  • Select Domotz from the list.

Setting up the Integration in Hudu

Step 1. Connect to Domotz

• Enter the following:
  • API Key Endpoint
    • Found in Domotz → Settings → API Keys
  • API Key

• Select Default Asset Layout

  • Choose an asset layout (must be active asset layout) from the list to designate as the default asset layout

  • This asset layout stores information that is pulled in but not explicitly mapped to another asset layout

  • The Domotz integration requires one default asset layout for:

    • Devices

• Select any data types to skip (optional)
• Select any additional options:
  • Auto-update names of Assets - If name is changed in Domotz, 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 Domotz
  • Sync SNMP details for each device

Step 2. Test connection and run initial sync

• On the integration overview page, click Test Connection
• If successful, start an initial sync to bring in Domotz clients/companies

Step 3. Match Domotz Companies

• Before [customers] from Domotz 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 Domotz are imported

  • They appear in the Matched Companies List for the integration

• Navigate to Hudu Admin → Integrations → Domotz

• 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 Domotz 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. Other sync locations

• Add Sort Rules

  • Sort Rules determine how data types from Domotz 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.
     

Step 5. Run final sync

• Once you save these settings, start a final sync to bring in Domotz devices

FAQ