Understanding Integrations

Hudu integrates with the tools you already use, turning it into your team’s central information hub.

Integrations connect Hudu with third-party applications, creating a secure communication channel that syncs data and enhances your overall experience.

Types of Integrations

There are three main types of integrations:

  1. Native Integrations
    Built by Hudu. These automatically resync every three hours and can also be re-synced manually at the integration or card level.

  2. Third-Party Tools
    External tools that push data between applications, including alerting integrations and authentication methods.

  3. Vendor-Created Integrations
    Integrations built by third-party applications (not by Hudu). These require your Hudu API credentials to configure.

    Native integrations automatically resync every three hours; but integrations can be resynced manually, both at an integration level (via the re-sync button) or at an individual card level.

Enabling Integrations

Integrations can be enabled during testing or in production and can be merged into existing documentation at any time.

To enable an integration:

  • Navigate to Admin Area → Integrations.

  • Select the integration you want to enable.

  • For native integrations, follow the setup guide for that integration.

  • Enter the required API or connection details.

  • Test the connection.

  • Click Start Sync.

  • Once complete, click Match Companies.

  • Match companies to existing Hudu companies or create new ones.

  • Re-run the integration.

Matching Companies

Before integration data can be imported, companies must be matched to existing or newly created Hudu companies.

When an integration runs successfully for the first time, it pulls in companies and adds them to the Matched Companies list.

To match companies:

  • Go to Admin Area → Integrations and select your integration.

  • Click Match Companies.

  • For each company, choose to:

    • Match it to an existing Hudu company

    • Create a new Hudu company

    • Leave it unmatched (no data will be imported)

  • Re-run the integration to import data for matched companies.

Default Asset Layouts

Default asset layouts act as a holding area for imported data that hasn’t been assigned elsewhere.

Most integrations require default layouts for items such as contacts, configurations, devices, or locations. The required layouts depend on the integration.

You will need to first create these Asset layouts in Admin > Asset Layouts for them to be available in the dropdown selector.

Sort Rules

Sort rules determine where imported data is placed within Hudu.

  • Assign integration data types to specific asset layouts.

  • Any data type without a sort rule is placed in the default asset layout.

  • Asset layouts can be created in advance (Admin Area → Asset Layouts) or created during setup.

After updating sort rules, save your settings and restart the integration sync.

Cards: How Integration Data Is Stored

Hudu stores integration data using cards.

  • Cards allow data from external sources to be stored, moved, and stacked under a single asset.

  • Cards live inside customizable asset layouts within each client.

  • A card can contain data from only one source (manual, CSV import, or integration).

  • Multiple cards with the same company and asset name are stacked together.

  • If needed, cards can be re-matched to a different asset.

    Visit The "Card" to learn more!

Some data points on integration cards can now be mapped to custom fields. For more information, please see our article on Connected Fields.

Troubleshooting Integrations

If an integration sync appears to be stuck, the Sidekiq queue may be backed up and need to be cleared.

To check Sidekiq, log in to your Hudu instance as an administrator and navigate to:
yourhuduinstance/sidekiq

From there, you can:

  • Stop any running processes
  • Delete dead jobs
  • Clear queued jobs

If you need assistance, please send screenshots of your Sidekiq pages to our support team at support@hudu.com.

Deletion Functionality

⚠️ Danger Section

Actions in this section can cause permanent data loss. Proceed with caution.

Delete All Agreements/Contracts

    Only available for integrations that pull agreements and contracts.

Using this function will delete all agreements and contracts that may be being pulled in from ALL integrations. ONLY use this function if you'd like to remove these completely.

Delete Configuration Types

    Only available for integrations that pull configurations.

Using this function will delete all configurations that may be being pulled in from the integration. ONLY use this function if you'd like to remove these completely.

Delete All Cards from Integration

Using this function will delete all integration cards that may be being pulled in from the integration.

  • This will not affect alternate information that may have been added to an asset created by the integration or pulled in from another integration.
  • The integration cards that are deleted will show up on subsequent re-syncs with the integration unless functionality is further removed or integration is fully deleted.
Delete All Integration Assets

Using this function will delete all assets that may be being pulled in from the integration.

  • If an asset was created inside of Hudu from this integration, utilizing this feature will delete ALL information on the asset, including any additional information that was manually input or pulled from another integration on the asset at a later date.
Delete Integration

Using this function will delete ALL assets and integration data that may be pulled in from the integration; as well as stop any subsequent re-syncs from bringing these assets in again.

  • If an asset was created inside of Hudu from this integration, utilizing this feature will delete ALL information on the asset, including any additional information that was manually input or pulled from another integration on the asset at a later date.

 

 

Native Integrations

 

 

PSA/RMM

 

To set up integrations with our supported PSA or RMM integrations, please refer to the guides below!

 

HaloPSA logo

HaloPSA

SyncroMSP logo

SyncroMSP

NinjaOne logo

NinjaOne

CW Manage logo

CW Manage

Autotask logo

Autotask

Datto RMM logo

DattoRMM

Atera logo

Atera

Kaseya BMS logo

Kaseya BMS

RepairShopr logo

RepairShopr

Pulseway logo

Pulseway

Addigy logo

Addigy

Level.io logo

Level.io

N-Able N-Sight logo

N-Able N-Sight

N-Central logo

N-Central

SuperOps logo

SuperOps

 

Productivity

 

To set up integrations with one of our supported productivity integrations, please refer to the guides below!

 

Microsoft 365 logo

Microsoft 365

QuickPass logo

QuickPass

CloudRadial logo

CloudRadial

MapBox logo

MapBox

OpenAI logo

OpenAI

Datto Backup logo

Datto Backup

Ubiquiti UniFi logo

Ubiquiti UniFi

Cloudflare logo

Cloudflare

CyberQP logo

CyberQP

HelpGhost logo

HelpGhost

Microsoft Intune logo

Microsoft Intune

Google Workspace logo

Google Workspace

Typesense logo

Typesense

     

 

Monitoring

 

To set up integrations with one of our supported monitoring integrations, please refer to the guides below!

 

Domotz logo

Domotz

Liongard logo

Liongard

Auvik logo

Auvik

Watchman logo

Watchman

SaaSAlerts logo

SaaSAlerts

     

 

Third-Party Tools

 

 

Authentication

 

To set up SAML SSO using common identity providers, please refer to their respective guides below!

 

Google Admin Console logo

Google Admin Console

Azure AD logo

Azure AD

JumpCloud logo

JumpCloud

Okta logo

Okta

AuthAnvil Passly logo

AuthAnvil (Passly)

OneLogin logo

OneLogin

 

Alerting

 

To set up WebHook alerts to common messaging providers, please refer to the guides below!

 

Slack logo

Slack

Microsoft Teams logo

Microsoft Teams

Discord logo

Discord

Generic Webhook logo

Generic Provider

Zapier logo

Zapier

     
Was this article helpful?
1 out of 3 found this helpful