> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Connect your NinjaOne RMM to Neo Agent for automated script execution and device management

NinjaOne integration enables Neo Agent to access your scripts, devices, and monitoring data through a streamlined OAuth authentication flow.

<Info>
  NinjaOne uses OAuth 2.0 for authentication, which provides a secure and simple setup process. No API keys to manage—just authenticate through the consent flow.
</Info>

## Prerequisites

Before starting the integration setup, ensure you have:

* **Admin Access**: Administrator access to your NinjaOne instance
* **OAuth Consent**: Ability to approve third-party application access
* **Region Information**: Know which region your NinjaOne instance is hosted in

## Setup Guide

<Steps>
  <Step title="Select your region">
    Navigate to the [Neo Agent Dashboard](https://dashboard.neoagent.io/integrations) and select **NinjaOne** from the RMM integrations.

    Select your NinjaOne region from the dropdown. This must match the region where your NinjaOne instance is hosted:

    | Region | Description                                 |
    | ------ | ------------------------------------------- |
    | US     | United States data center                   |
    | EU     | European Union data center                  |
    | OC     | Oceania (Australia/New Zealand) data center |

    <Warning>
      Selecting the wrong region will cause authentication to fail. Check your NinjaOne login URL to confirm your region.
    </Warning>
  </Step>

  <Step title="Authenticate with NinjaOne">
    Click the **Authenticate** button to start the OAuth consent flow.

    A popup window will open directing you to NinjaOne's authentication page:

    1. Log in with your NinjaOne administrator credentials
    2. Review the permissions Neo Agent is requesting
    3. Click **Authorize** or **Allow** to grant access

    <Info>
      You must be an administrator of your NinjaOne instance to complete the consent flow. Standard users cannot authorize third-party integrations.
    </Info>
  </Step>

  <Step title="Complete the consent flow">
    Once you've authorized access, you'll be redirected back to Neo Agent.

    <Check>
      The integration status will update to show NinjaOne is connected. Neo Agent now has access to your devices and scripts.
    </Check>
  </Step>
</Steps>

## OAuth Permissions

When authorizing Neo Agent, you'll grant access to the following:

| Permission           | Purpose                                 |
| -------------------- | --------------------------------------- |
| Devices - Read       | Access device information and inventory |
| Devices - Manage     | Execute scripts and management tasks    |
| Scripts - Read       | Browse available automation scripts     |
| Scripts - Execute    | Run scripts on managed devices          |
| Alerts - Read        | Access monitoring alerts                |
| Alerts - Manage      | Clear and acknowledge alerts            |
| Organizations - Read | Access client/organization information  |

<Tip>
  Neo Agent only requests the permissions necessary for automation. Your NinjaOne data remains secure, and you can revoke access at any time from your NinjaOne settings.
</Tip>

## What Neo Can Do

With NinjaOne connected, Neo Agent can:

<AccordionGroup>
  <Accordion title="Script Execution">
    * Browse your script library organized by categories
    * Execute scripts on specific devices or device groups
    * Monitor script job status in real-time
    * Process script output for automated decision-making
  </Accordion>

  <Accordion title="Device Management">
    * Search devices by name, serial number, or other attributes
    * Access comprehensive device details and specifications
    * View installed software and running processes
    * Identify devices associated with end users or organizations
  </Accordion>

  <Accordion title="Monitoring and Alerts">
    * Access active alerts and monitoring conditions
    * Process alerts for automated remediation
    * Clear alerts after successful resolution
    * Correlate device status with ticket context
  </Accordion>

  <Accordion title="Organization Management">
    * Access organization/client information
    * Map organizations to PSA companies
    * Filter devices and scripts by organization
  </Accordion>
</AccordionGroup>

## Managing the Integration

### Refreshing Authorization

OAuth tokens automatically refresh, but if you encounter authentication issues:

1. Navigate to the NinjaOne integration in Neo Agent
2. Click **Reconnect** or **Re-authenticate**
3. Complete the OAuth flow again

### Revoking Access

To disconnect Neo Agent from NinjaOne:

1. In Neo Agent: Navigate to integrations and click **Disconnect** for NinjaOne
2. In NinjaOne: Go to **Administration → Apps** and revoke access for Neo Agent

<Warning>
  Revoking access will immediately stop all Neo Agent automations that rely on NinjaOne. Ensure you have alternative processes in place before disconnecting.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth Popup Blocked">
    * Check your browser's popup blocker settings
    * Allow popups from `dashboard.neoagent.io`
    * Try using a different browser
  </Accordion>

  <Accordion title="Wrong Region Selected">
    * Disconnect the integration in Neo Agent
    * Verify your region by checking your NinjaOne login URL
    * Reconnect with the correct region selected
  </Accordion>

  <Accordion title="Consent Flow Fails">
    * Ensure you're logged into NinjaOne as an administrator
    * Check that third-party app access is not disabled in your NinjaOne settings
    * Contact NinjaOne support if organization policies restrict OAuth apps
  </Accordion>

  <Accordion title="Devices Not Appearing">
    * Verify the OAuth authorization completed successfully
    * Check that your NinjaOne user has access to the relevant organizations
    * Ensure devices are active and checking into NinjaOne
  </Accordion>
</AccordionGroup>

## External Resources

<CardGroup cols={2}>
  <Card title="NinjaOne API Documentation" icon="link" href="https://app.ninjarmm.com/apidocs/">
    Official NinjaOne API reference and documentation.
  </Card>

  <Card title="NinjaOne Support" icon="headset" href="https://www.ninjaone.com/support/">
    Contact NinjaOne support for platform-specific questions.
  </Card>
</CardGroup>