ConnectWise PSA Connection Guide

A step-by-step guide to getting your ConnectWise PSA account connected to the Synthesize Platform


Existing partners looking to connect Alerts will need to edit and update their existing API key to include:

Under Service Desk enable Add, Edit, and Inquire permissions to Close Service Tickets, Merge Tickets & Service Tickets. Also in Security Roles > Role > System > Table Setup (customize) ensure "Service / Service Board" has been added to the role. 

Once updated, Save and proceed to connect Alerts within Gradient. 

On-Premise Requirements

So, you've gone on-premise? Do you like to nurture and keep that little flaminglet protected? Respect! That shouldn't stop you from using the Synthesize platform. Here are the minimum requirements for on-premise environments.

  1. Fully Chained SSL Certificate.
  2. The latest stable version of ConnectWise PSA.
  3. If your ConnectWise PSA instance restricts access based on IP, our IPs are &

ConnectWise PSA Connection Checklist

If you haven't already registered, you can open a Gradient MSP account here 

You've registered and are on your way to officially becoming part of the flock! Take the following steps to get ConnectWise PSA connected with the Synthesize platform:

  1. Upon initial registration of your new Gradient MSP account, you will select ConnectWise PSA and click Next. You will then be presented with a connection checklist. Please gather these items before progressing to the next page.
  2. Login to ConnectWise PSA
  3. Navigate to System > Security Roles.
  4. Create a new Security Role with the following permissions:

    1. Expand Companies and grant Inquire to Company Maintenance

      1. expand companies
    2. Expand Finance and grant Inquire to Agreement Sales
      1. expand finance and grant inquire
    3. Within Finance, grant Add, Edit, and Inquire to Agreements. Select Customize for Agreements, and ensure all sections are set to Allow.
      1. within finance grant add, edit and inquire to agreements
    4. Expand Procurement and grant Inquire to Product Catalog and Products.
      1. procurement
    5. Expand Service Desk and grant Add, Edit, and Inquire to Close Service Tickets, Merge Tickets, and Service Tickets.
      1. expand service desk and
    6. Expand System and grant Add, and Inquire to Table Setup. Select Customize for Table Setup and ensure "Company / Company Status", "Company / Company Type", "Invoicing / Billing Cycle", and "Service / Service Board" is set to Allow.
      1. table set up
      2. update security image
  5. Navigate to System > Members > API Members tab and create a new API member and assign the newly created Security Role, then save the member.
  6. Navigate to the API Keys tab. Create a new API Key and add a description.
  7. Click Save and keep a record of the Public and Private Keys.
  8. Keep a record of the Company ID, URL (, and both the Public and Private API Keys ready for the next step.
  9. Input your Public Key, Company ID, Private Key, and URL. 
  10. Click Save and Test.

Congratulations, you've successfully connected your PSA!

Sit back, have a coffee, and let our hamsters (or flamingos in this case) get to work synchronizing your data. You can close the Setup Wizard now if you like, and we will email you when the synchronization is complete.