Skip to main content

Setting Up the NinjaRMM Integration

Updated over a week ago

Overview

The NinjaRMM integration connects your NinjaOne RMM platform to Junto, enabling your AI agent to monitor endpoints, query device information, and run remediation scripts across your managed devices.

What you can do once connected

  • View device details — hardware specs, OS, online status, and network info

  • Query installed software, disk health, and storage across all devices

  • Monitor antivirus status and detected threats organization-wide

  • View active alerts and device health summaries

  • Run remediation scripts on managed devices (with approval)

  • Search for logged-in users across your endpoints

Prerequisites

  • A NinjaRMM (NinjaOne) account with API access

  • Admin or Owner role in your Junto organization

  • An OAuth application configured in NinjaRMM

Creating your NinjaRMM OAuth application

  1. Log in to your NinjaRMM account

  2. Navigate to Administration > Apps > API

  3. Click "Add" to create a new OAuth application

  4. Set the application name (e.g., "Junto AI")

  5. For the Redirect URI, you'll copy this from Junto in the next step

  6. Set the scopes to include monitoring, management, and control

  7. Save and copy your Client ID and Client Secret

Step 1: Add your NinjaRMM configuration

  1. In Junto, navigate to Settings → Integrations → NinjaRMM

  2. Click "Add Configuration"

  3. You'll see a form with the following fields:

    • OAuth Redirect URL (read-only) — copy this URL and paste it into your NinjaRMM OAuth application settings

    • Client ID — paste your NinjaRMM OAuth Client ID

    • Client Secret — paste your NinjaRMM OAuth Client Secret (encrypted on save)

    • Region — select the region matching your NinjaRMM instance:

      • United States — app.ninjarmm.com

      • Europe — eu.ninjarmm.com

      • Oceania — oc.ninjarmm.com

  4. Click "Create"

Step 2: Map your companies

Company mapping links your Junto companies to NinjaRMM organizations, so the agent knows which devices belong to which client.

  1. Click "Configure Company Mapping" on the configuration card

  2. A dialog opens showing your Junto companies alongside a dropdown of NinjaRMM organizations

Auto-mapping (recommended)

Click "Run Auto-Map" to let Junto match companies by name:

  • Exact matches are applied immediately

  • Fuzzy matches (80%+ similarity) are shown as suggestions for your review

Manual mapping

Select the correct NinjaRMM organization from the dropdown for each Junto company, then click "Save Mappings".

Step 3: Sync devices

  1. Click "Sync Devices" on the configuration card

  2. Junto pulls device information from NinjaRMM for all mapped organizations

  3. Devices are now available for the AI agent to query

Running scripts (optional setup)

Running remediation scripts on devices requires an additional per-user authorization step:

  1. When the agent needs to run a script, it will request your approval

  2. You'll see an authorization button in the approval dialog

  3. Click to open a popup where you personally authorize with NinjaRMM

  4. Once authorized, the script executes with your NinjaRMM credentials

This extra step ensures scripts always run under a specific user's authority, not just the integration's service account. Script execution is a high-risk action and always requires explicit approval.

Using the integration

Once connected and mapped, your AI agent can query NinjaRMM during triage. For example:

  • "What's the disk health on John's laptop?"

  • "List all devices with outdated antivirus for Acme Corp"

  • "What software is installed on DESKTOP-ABC123?"

  • "Are there any active alerts across our endpoints?"

  • "Run the ClearTempFiles script on the user's workstation"

Troubleshooting

Issue

Solution

Connection fails after setup

Verify Client ID, Client Secret, and region are correct

Redirect URL mismatch error

Copy the exact OAuth Redirect URL from Junto into your NinjaRMM app settings

Organizations not appearing

Check that your NinjaRMM OAuth app has the correct scopes enabled

Auto-map finds no matches

Company names may differ — use manual mapping instead

Script execution shows "No user token"

You need to complete the per-user OAuth authorization when prompted

Token expired badge showing

Tokens auto-refresh on the next API call — try the action again

Did this answer your question?