Skip to main content

​
Setup Overview

Setting up the ConnectWise ScreenConnect integration involves two main steps:

Creating an API Secret

Install the RESTful API Manager extension in ScreenConnect and copy its authentication secret.

Connecting to Neo Agent

Configure the connection between your ScreenConnect instance and Neo Agent using your instance URL and the API secret.

​
Prerequisites

Before starting the integration setup, ensure you have:
  • Admin Access: An administrator account on your ScreenConnect instance with permission to install and configure extensions
  • Your instance URL: e.g. https://yourcompany.screenconnect.com
ConnectWise ScreenConnect (also sold as ConnectWise Control) is a remote-support and access tool. Neo Agent talks to it through the RESTful API Manager extension — there is no separate REST API to enable, just the extension and its authentication secret.

​
What Neo Can Do with ScreenConnect

Neo Agent reads installed-agent (session) data and, where you allow it, runs commands and messages end users — gated by per-area permission groups you configure in Agent Settings.
API actions only — not interactive remote control. Neo works through the RESTful API Manager: it queries devices, runs commands and Toolbox items, and messages end users programmatically. Neo does not start an interactive remote-control session — no screen viewing or takeover, no manual keyboard/mouse control, and it never “logs in” to drive the desktop by hand. A technician still does that from the ScreenConnect client.
  • Session lookup — find installed agents by name or filter, read session detail (operating system, last-contact time, online status, custom properties)
  • Command output — read the result of commands queued on a session
  • Write — create support sessions, rename sessions, update custom properties, add notes
  • Execute — send a shell or PowerShell command to a session and read back the output
ScreenConnect commands run with the agent’s privileges — SYSTEM on Windows, root elsewhere. Enable Require approval on the Commands group to gate every command behind a technician.
  • Toolbox — run a pre-staged Toolbox item on the endpoint
  • Messaging — send a chat message to the logged-on end user
Write access is opt-in per area. In Agent Settings → Permission Groups, set the relevant ScreenConnect groups to Read & Write to enable session writes, command execution, and messaging.

​
Available Actions

CategoryActionsStatus
SessionsFind sessions, read session detail and command outputAvailable (read)
SessionsCreate sessions, rename, update custom properties, add notesAvailable (read/write)
CommandsSend a shell/PowerShell command and read the outputAvailable (read/write)
Toolbox & MessagingRun a pre-staged Toolbox item, send a chat message to the end userAvailable (read/write)
Neo Agent uses the ScreenConnect RESTful API Manager. There is no script catalog — Neo sends the command text directly, so no scripts need to be pre-registered for command execution.