> ## Documentation Index
> Fetch the complete documentation index at: https://university.triggr-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ConnectWise ScreenConnect

> Connect ConnectWise ScreenConnect to Triggr with the RESTful API Manager extension and a secret you set.

Triggr finds ScreenConnect sessions, updates their custom properties and calls the RESTful API Manager's other methods, such as sending a command to a session. It needs ScreenConnect 22.3 or later, cloud or on-premises.

## Set up ScreenConnect

<Steps>
  <Step title="Install the RESTful API Manager">
    Go to **Admin > Extensions**, click Browse Extension Marketplace, find RESTful API Manager and click Install. If it's already installed, click Check for Updates.
  </Step>

  <Step title="Set the authentication secret">
    Open the extension's Options menu and select Edit Settings. Enter a long random string in the Custom field for **RESTfulAuthenticationSecret**, leave RESTfulAllowedOrigin empty and click Save Settings. Anyone with the secret can send commands to your machines, so store it like an administrator password.
  </Step>

  <Step title="Find your hostname">
    It's the address you open ScreenConnect at, without `https://`, such as `yourcompany.screenconnect.com`. An on-premises server must serve HTTPS at a public address; add the port if it isn't 443 (`support.example.com:8443`) and allow [Triggr's IP addresses](/security/ip-allowlist) through any firewall.
  </Step>
</Steps>

See ConnectWise's [RESTful API Manager](https://docs.connectwise.com/ConnectWise_ScreenConnect_Documentation/Supported_extensions/Administration/RESTful_API_Manager) guide.

## Connect it in Triggr

<Steps>
  <Step title="Open the client's configuration">
    Go to **Integrations > ConnectWise ScreenConnect** and click **Configure** on the client's row in the Per-Client Configuration card.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/per-client-configuration.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=11464b4946bea0b580c73330d9114a41" alt="The Per-Client Configuration card listing Acme Corp and Globex, each Not Configured with Admin Consent Not Required and a Configure button." width="2272" height="646" data-path="images/integrations-common/per-client-configuration.png" />
    </Frame>
  </Step>

  <Step title="Enter the instance details">
    Enter the Hostname and the secret as Restful Authentication Secret, then click **Save Configuration**. For an on-premises server with a self-signed or internal certificate, turn on Allow insecure TLS first.

    <Frame>
      <img src="https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/connectwise-screenconnect/configure.png?fit=max&auto=format&n=MwzXHG3UWzFixdSz&q=85&s=da3fe18fb466cfa2eb28abfe2468e55b" alt="The ConnectWise ScreenConnect configuration window with Hostname and Restful Authentication Secret fields, an Allow insecure TLS switch under Advanced, and a Save Configuration button." width="1344" height="1078" data-path="images/connectwise-screenconnect/configure.png" />
    </Frame>
  </Step>
</Steps>

Most MSPs enter the same instance for every client; each row holds its own copy. Per-client integrations never fall back to the Base Configuration, so a client without its own row fails its ScreenConnect steps. The Base Configuration is only for workflows that don't run for a client.

## Use ScreenConnect in workflows

* Set every action's `appExtensionId` to `2d558935-686a-4bd0-9991-07539f5fe749`, the extension's ID on every instance.
* Get Sessions By Filter takes a [session group filter](https://docs.connectwise.com/ScreenConnect_Documentation/Get_started/Host_page/Session_groups/Session_groups_filter_reference), such as `CustomProperty1 = 'Contoso'`.
* Make Post Request takes a method name as `endpoint`, such as `SendCommandToSession`, and its parameters in order as a JSON array, such as `["<session ID>", "ipconfig"]`.

## Troubleshooting

<AccordionGroup>
  <Accordion title="No ConnectWise ScreenConnect integration is configured for this client">
    Configure the client on the Per-Client Configuration card, then run the workflow again.
  </Accordion>

  <Accordion title="Authentication errors on every request">
    Check the secret matches RESTfulAuthenticationSecret exactly, RESTfulAllowedOrigin is empty and the extension isn't Inactive. If you changed the secret, update every row.
  </Accordion>

  <Accordion title="Triggr can't connect to the instance">
    Hostname must be only the hostname and port, with no `https://` or path, served over HTTPS at a public address. For certificate errors, turn on Allow insecure TLS in each row that uses the server.
  </Accordion>

  <Accordion title="The method isn't found">
    Check `appExtensionId` and the `endpoint` spelling. `AddNoteToSession` needs version 1.0.6 or later of the extension.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.