Skip to content

Initial setup in ConnectWise

Follow these steps to begin integrating.

Check that you have the integrator login account in ConnectWise. If the integrator account has been removed or deleted, you need to recreate it before you start. See ConnectWise Integrator Login Setup Table.

We recommend that you generate API keys for a member or members, rather than for an account. This gives you greater control over who can access APIs, lets you track activity by members, and helps with debugging (for example, if there is a synchronization error).

To generate API keys, do as follows.

  1. In ConnectWise, go to System > Members.
  2. Select the API Members tab and click Plus icon. to add a member.

    API members.

  3. Enter the details of an administrator. Save the new member.

    New member page.

  4. In the list of members, click the new member's name.

  5. Select the API Keys tab and click Plus icon..

    API keys in ConnectWise.

  6. In the Description field, enter a description for the new key (for example Sophos Central Integration).

    API key.

  7. Click Save.

    Do not use Save and Close.

  8. Two API keys are generated and displayed: a Public Key and a Private Key. The Private Key is only displayed at the time the key is created. Make a note of both keys, as you will need them to synchronize Sophos Central customers with ConnectWise.

    Note

    Make a note of both keys or copy them to the clipboard as there is no way to recover the Private Key once the tab is closed.

  9. Check that the credientials for the API Keys have the correct permissions to access the Catalog. Permissions are based upon security roles.Go to System > Security Roles and select role for this integration. Set up the permissions as follows:

    1. Assign Member as the Security Permission.
    2. Under Companies, select Company Maintenanceand set Inquire Level = All.

      Company permission levels.

    3. Under Finance, select Agreements and set Add Level = All, Edit Level = All, and Inquire Level = All.

      Finance permission levels.

    4. Under Procurement, select Product Catalog and set Add Level = All, Edit Level = All and Inquire Level = All.

      Procurement permission levels.

    5. Under System, select Table Setup and set Add Level = All, Edit Level = All, and Inquire Level = All.

      Table permission levels.

    6. Under System, select Member maintenance and set Inquire Level = All.

      Member permission levels.

    7. Under Service Desk, select Service Tickets and set Inquire Level = All, Add Level = All and Edit Level = All.

      Service ticket permission levels.

    8. Select API Reports and set Inquire Level = All.

      API report permission levels.