> ## 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 N-Able N-Sight RMM to Neo Agent for automated script execution and device management

N-Able N-Sight RMM integration enables Neo Agent to access your scripts, devices, and monitoring data for powerful automation capabilities.

## Prerequisites

Before starting the integration setup, ensure you have:

* **Admin Access**: Administrator access to your N-Sight RMM dashboard
* **API Permissions**: Ability to generate and manage API keys
* **Account Access**: Access to the API configuration section

## Setup Guide

<Steps>
  <Step title="Access API settings">
    Log into your N-Sight RMM dashboard and navigate to the API configuration section.

    1. Go to **Settings** in the main navigation
    2. Select **API Settings** or **Manage API Keys**

    <Info>
      The exact location may vary slightly based on your N-Sight RMM version and configuration.
    </Info>
  </Step>

  <Step title="Generate API key">
    Create a new API key with the appropriate permissions for monitoring and automation:

    1. Click **Generate New API Key** or **Add API Key**
    2. Provide a descriptive name (e.g., "Neo Agent Integration")
    3. Configure the key permissions to include:
       * Device access (read/write)
       * Script execution
       * Alert management
       * Monitoring data access
    4. Generate the key and securely store both the **API Key** and **Secret**

    <Warning>
      The API secret is only shown once during generation. Store it securely as you cannot retrieve it later.
    </Warning>
  </Step>

  <Step title="Configure in Neo Agent">
    Navigate to the [Neo Agent Dashboard](https://dashboard.neoagent.io/integrations) and select **N-Able N-Sight** from the RMM integrations.

    Enter your credentials:

    * **API Key**: The key generated from N-Sight
    * **API Secret**: The secret associated with your API key

    <Check>
      Make sure to enter the credentials exactly as provided—they are case-sensitive.
    </Check>
  </Step>

  <Step title="Test and save">
    Neo Agent will validate your credentials and establish the connection to your N-Sight RMM instance.

    <Check>
      A successful connection allows Neo to access your devices, scripts, and monitoring data.
    </Check>
  </Step>
</Steps>

## Required Permissions

Ensure your API key has the following permissions enabled:

| Permission        | Purpose                                 |
| ----------------- | --------------------------------------- |
| Devices - Read    | Access device information and inventory |
| Devices - Write   | Execute scripts and management tasks    |
| Scripts - Execute | Run automation scripts on devices       |
| Alerts - Read     | Access and process monitoring alerts    |
| Alerts - Write    | Clear alerts after remediation          |
| Monitoring - Read | Access monitoring data and status       |

<Tip>
  Create a dedicated API key specifically for Neo Agent rather than using an existing key. This makes it easier to manage permissions and audit API access.
</Tip>

## What Neo Can Do

With N-Able N-Sight connected, Neo Agent can:

<AccordionGroup>
  <Accordion title="Script Execution">
    * Browse available scripts in your library
    * Execute scripts on specific devices or device groups
    * Monitor script execution status
    * Process script results for automated follow-up actions
  </Accordion>

  <Accordion title="Device Management">
    * Look up devices by various identifiers
    * Access device details, hardware specs, and software inventory
    * View device status and health metrics
    * Identify devices associated with end users or tickets
  </Accordion>

  <Accordion title="Monitoring and Alerts">
    * Access monitoring check results
    * Process and respond to alerts
    * Clear alerts after successful remediation
    * Correlate monitoring data with ticket context
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection Failed">
    * Verify the API Key and Secret are entered correctly
    * Check that the API key has not expired
    * Ensure the API key has the required permissions
    * Confirm API access is enabled for your account
  </Accordion>

  <Accordion title="Permission Denied Errors">
    * Review the API key permissions in N-Sight
    * Ensure all required permissions are enabled
    * Regenerate the API key if permissions were changed after creation
  </Accordion>

  <Accordion title="Devices Not Appearing">
    * Check that the API key has device read permissions
    * Verify the devices are active and checking in
    * Ensure site/client access permissions are configured
  </Accordion>
</AccordionGroup>

## External Resources

<Card title="N-Able N-Sight API Documentation" icon="link" href="https://developer.n-able.com/n-sight/docs/generate-an-api-key">
  Official N-Able developer documentation for API key generation and reference.
</Card>