ConnectWise ScreenConnect integration
What does the ConnectWise ScreenConnect integration do?
Run commands on your ConnectWise ScreenConnect agents and get logs from your sessions.
Set up the ConnectWise ScreenConnect integration
Setup steps in ConnectWise ScreenConnect
Heads up!
ConnectWise ScreenConnect utilizes the CustomProperty1
property—typically referenced as Company
within the UI—to store the organization name.
If you are using this property for another purpose, you will need to update the CustomProperty1
property to store the organization name.
Click the Admin button on the left-hand side of the screen on your ConnectWise ScreenConnect instance.
Click Security in the left side menu.
Click Show User Table under the Internal submenu.
Click Create User.
Fill out the required data.
Ensure that you check on at minimum the Control Admin permission.
Make a note of the username, password, and OTP secret , which you'll need for setup steps in Rewst.
Click Save User.
The steps to generate your OTP secret will differ depending on your MFA tool. See ConnectWise's own documentation here for steps pertaining to your particular MFA method.
Setup steps in Rewst
Navigate to Configuration > Integrations in the left side menu of your Rewst platform.
In the Integrations page, search for the ConnectWise ScreenConnect integration.
Click on the integration tile to launch the Configuration setup page.
Under Configuration:
Edit the Name
Add an optional Description for your configuration.
Check on Is Default.
Under Parameters:
Enter your ConnectWise ScreenConnect domain in the Hostname field.
Enter the password you created for your Rewst API user in the Password field.
Enter the username for your Rewst user in the Username field.
Enter the base32 OTP secret copied from ConnectWise ScreenConnect into the TOTP Secret field.
Click Save Configuration.
Rewst will do a quick validation of your input. Once completed, you'll see a new section beneath the configuration form for organization mapping. Complete your mapping as desired.
You may run into a scenario where refesh options is not working. If this is the case, you can change the root session group to All Machines to see if it pulls in customers. If this doesn't resolve the issue, you can contact support as found here: Support priorities
ConnectWise ScreenConnect Failed Authentication
When using the ConnectWise Control - ConnectWise Control API Request
action, the token can expire in transit when ConnectWise is sending the response back to Rewst.
This will then result in a failed authentication against the user set in the integration. When there are a number of these failed authentication attempts in rapid succession, the user account will get locked out.
This is most commonly seen in cases where a workflow is scheduled to run across multiple computers at multiple orgs for a customer.
Troubleshoot the ConnectWise ScreenConnect integration
Failed to refresh options: Error failed to get sessions

In ScreenConnect:
Create a session group named
All Machines by Company
and give it a sub group expression ofCustomProperty2
.Create a session group called
All Machines
with no sub group expression.
In Rewst:
Navigate to the ConnectWise ScreenConnect integrations' configuration page.
Set the following values:
Organization Subgroup Expression:
CustomProperty2
Root Session Group:
All Machines by Company
View ConnectWise's own documentation for how to create a session group in the below video.
Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our Canny feedback collector.
Actions and endpoints
Get session
Used to help you debug issues with your PowerShell scripts by providing logs associated with a specific connection ID.
Parameters
Connection ID
String
Required. The Connection ID provided by the "Invoke Command" Action.
Event Types
Array[[Event Type](#event-types]
Required. The event types to filter the logs.
Invoke command
Action to run a command template on an agent.
Invoke command parameters
script
Template
Required. The Powershell script template. You can create this under Automations → Scripts.
Reference types
Session
A reference to a "Session" within ConnectWise ScreenConnect.
Session group
A reference to a session group within ConnectWise ScreenConnect.
Event types
Connected
10
Disconnected
11
CreatedSession
20
EndedSession
21
InitiatedJoin
30
InvitedGuest
31
AddedNote
32
QueuedReinstall
40
QueuedUninstall
41
QueuedInvalidateLicense
42
QueuedWake
43
QueuedCommand
44
QueuedMessage
45
QueuedGuestInfoUpdate
46
QueuedTool
47
QueuedForceDisconnect
48
ProcessedReinstall
50
ProcessedUninstall
51
ProcessedInvalidateLicense
52
ProcessedWake
53
ProcessedCommand
54
ProcessedMessage
55
ProcessedGuestInfoUpdate
56
ProcessedTool
57
ProcessedForceDisconnect
58
ModifiedName
60
ModifiedIsPublic
61
ModifiedCode
62
ModifiedHost
63
ModifiedCustomProperty
64
RanCommand
70
SentMessage
71
SentPrintJob
80
ReceivedPrintJob
81
CopiedText
82
CopiedFiles
83
DraggedFiles
84
RanFiles
85
SentFiles
86
Last updated
Was this helpful?