NinjaOne

What You'll Need

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

Integration Features

• Organizations.
  • Create client spaces within Hudu directly from Ninja companies, or seamlessly merge them into existing (already-created) client spaces.
• Devices.
  • Pull device information from NinjaOne; sorted into asset layouts based on set sort rules and your primary sync location(s).
• Locations.
  • Pull locations from NinjaOne.

What Hudu needs from NinjaOne

• Client ID.
• Client Secret.

Obtaining the NinjaOne Information

• Login to NinjaRMM and click on Administration on the sidebar.
• On the left-hand sidebar, click Apps.
• Select API
• Click Client App IDs >> Add. Fill the fields in as shown.

Setting up the Integration in Hudu

Step 1. Connect to Ninja

• Copy the Client ID and Client Secret credentials into Hudu.
  • The secret key credential opens in a new window; only visible one time.
  • The client ID can be found in the list view of applications in Ninja after closing the client secret window.
    • The Client ID is NOT the name of the application that you designated earlier; this is provided directly by Ninja.

• Select either the US2, European, Oceania or Canadian region (if this applies to you).

• If you utilize NinjaOne's SSO, enter your SSO URL to allow the "Launch" button from Hudu to NinjaOne to direct to the correct URL. 

• Select Skip Importing Devices (optional)

• Select Default Asset Layouts

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

  • They store information that is pulled in but not explicitly mapped to another asset layout

  • The NinjaOne integration requires two default asset layouts:

    • Configurations

    • Locations

      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 Ninja, 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 Ninja
  • Save the settings

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 NinjaOne companies

Step 3. Match Ninja Companies

• Before companies from Ninja 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 Ninja are imported

  • They appear in the Matched Companies List for the integration

• Navigate to Hudu Admin → Integrations → NinjaOne

• 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 Ninja 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 Ninja assets will fill to

• Add Sort Rules

  • Sort Rules determine how data types from Ninja 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 the Settings

Step 5. Test connection and run a final sync

• Test the connection from the integration overview page
• If successful, stop and restart the sync to bring in Ninja devices and locations

FAQ