Skip to content
Last update: 2022-05-10

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.
    3. Under Finance, select Agreements and set Add Level = All, Edit Level = All, and Inquire Level = All.
    4. Under Procurement, select Product Catalog and set Add Level = All and Inquire Level = All.
    5. Under System, select Table Setup and set Add Level = All, Edit Level = All, and Inquire Level = All.
    6. Under System, select Member maintenance and set Inquire Level = All.
    7. Under Service Desk, select Service Tickets and set Inquire Level = All, Add Level = All and Edit Level = All.
    8. Select API Reports and set Inquire Level = All.

      ConnectWise role permissions

    9. Make sure that the role has access to Members.

      Tip

      If you are unsure how to do this see the ConnectWise documentation.

Back to top