> ## 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.

# Generating API Credentials

> Create API access credentials in ConnectWise Asio for Neo Agent integration

To enable Neo Agent to interact with your ConnectWise Asio system, you need to generate API access credentials with the appropriate scopes.

<Info>
  This process involves generating API access credentials (Client ID and Client Secret) in your ConnectWise Asio portal with specific permissions that allow Neo to access your scripts and devices.
</Info>

## Creating API Access Credentials

<Steps>
  <Step title="Navigate to API Access">
    Log in to your ConnectWise Asio portal and navigate to the API Access section:

    1. Click **Integrations** in the left navigation menu
    2. Select **API Access** from the submenu

    <Frame>
      <img src="https://mintcdn.com/neoagent/lnHVT6AhqzwOEpVm/images/cwasio/cw-asio-1.png?fit=max&auto=format&n=lnHVT6AhqzwOEpVm&q=85&s=1e037358d2827a6cf13c07f80e699f0a" alt="ConnectWise Asio navigation showing Integrations menu expanded with API Access option highlighted" width="2804" height="1342" data-path="images/cwasio/cw-asio-1.png" />
    </Frame>
  </Step>

  <Step title="Generate API Access">
    Click the **Generate API Access** button in the top right corner of the API Access page to create new API credentials.

    <Frame>
      <img src="https://mintcdn.com/neoagent/lnHVT6AhqzwOEpVm/images/cwasio/cw-asio-1.png?fit=max&auto=format&n=lnHVT6AhqzwOEpVm&q=85&s=1e037358d2827a6cf13c07f80e699f0a" alt="API Access page showing the Generate API Access button" width="2804" height="1342" data-path="images/cwasio/cw-asio-1.png" />
    </Frame>
  </Step>

  <Step title="Configure API Access Details">
    Fill in the API access configuration form:

    1. **API Key Name**: Enter a descriptive name (e.g., `neoagent`)
    2. **Description**: Add a description for reference (e.g., `Neo Agent Integration`)
    3. **Scopes**: Select the required scopes for Neo Agent:
       * `Platform - Agent - Read`
       * `Platform - Assets - Read`
       * `Platform - Automation - Read`
       * `Platform - Automation - Create`
       * `Platform - Companies - Read`
       * `Platform - Contacts - Read`
       * `Platform - Devices - Read`
       * `Platform - Sites - Read`
       * `Platform - Tickets - Read`
    4. **Consent**: Check the consent box to acknowledge the API access terms

    <Frame caption="API Access configuration form with required fields">
      <img src="https://mintcdn.com/neoagent/lnHVT6AhqzwOEpVm/images/cwasio/cw-asio-2.png?fit=max&auto=format&n=lnHVT6AhqzwOEpVm&q=85&s=8260b58074f66eb77a5a9895e705a2ff" alt="Generate API Access form showing API Key Name, Description, Scopes dropdown, and Consent checkbox" width="2854" height="1350" data-path="images/cwasio/cw-asio-2.png" />
    </Frame>

    <Warning>
      Ensure all required scopes are selected. Missing scopes can cause Neo Agent to fail when attempting to execute scripts or access device information.
    </Warning>
  </Step>

  <Step title="Generate and Save Credentials">
    Click **Generate API Access** to create your credentials. A panel will appear showing your Client ID and Client Secret.

    <Frame caption="Generated API credentials - save these immediately">
      <img src="https://mintcdn.com/neoagent/lnHVT6AhqzwOEpVm/images/cwasio/cw-asio-3.png?fit=max&auto=format&n=lnHVT6AhqzwOEpVm&q=85&s=582e7cf381328da2d9ddfa00ab26a0f8" alt="Generated API Access panel showing Client ID and Client Secret with copy buttons" width="2846" height="1322" data-path="images/cwasio/cw-asio-3.png" />
    </Frame>

    <Warning>
      **Important**: Copy both the **Client ID** and **Client Secret** immediately and store them securely. The Client Secret cannot be recovered if lost—you will need to regenerate new credentials.
    </Warning>

    <Check>
      Before closing this panel, ensure you have saved:

      * The **Client ID** (visible in the form)
      * The **Client Secret** (hidden by default, click to reveal)
    </Check>
  </Step>
</Steps>

## Required Scopes Reference

The following scopes are required for Neo Agent to function properly:

| Scope                            | Purpose                                          |
| -------------------------------- | ------------------------------------------------ |
| `Platform - Agent - Read`        | Access agent information                         |
| `Platform - Assets - Read`       | Access asset and hardware inventory              |
| `Platform - Automation - Read`   | List available scripts and automation policies   |
| `Platform - Automation - Create` | Execute scripts on devices (coming soon)         |
| `Platform - Companies - Read`    | Access company/client information                |
| `Platform - Contacts - Read`     | Access contact information                       |
| `Platform - Devices - Read`      | Access device details and status                 |
| `Platform - Sites - Read`        | Access site configurations                       |
| `Platform - Tickets - Read`      | Access ticket information for device correlation |

<Info>
  If you need Neo to perform additional actions in the future, you may need to regenerate API credentials with additional scopes.
</Info>

## What's Next?

Once you've successfully generated your API credentials, you're ready to [connect them to Neo Agent](/integrations/rmm/connectwise-rmm/connecting-to-neo) using the Client ID and Client Secret from your ConnectWise Asio portal.

<Check>
  Before proceeding, ensure you have:

  * The **Client ID** from your generated API access
  * The **Client Secret** from your generated API access
  * Your ConnectWise Asio **region** (US, EU, or AU)
</Check>