Setting up ConnectWise Manage API Key authentication

This article outlines the steps needed to set up your SmileBack integration with ConnectWise Manage:

1. Create an API Member for SmileBack
2. Create an API Key
3. Enter the API Key into SmileBack

Creating an API member

1. In ConnectWise Manage, go to System > Members > API Members 
2. Click + to create a new API member
3. In the Member ID field type SmileBack
4. Enter an email address (this should be a functioning email address at your company)
5. Under System, select the Role ID Admin - or - select the custom SmileBack security role you previously created.
   
   
6. In the Service Defaults section you can block the member from accessing certain boards by adding them to the Restrict Board Access field. This mean SmileBack will not be able to fetch ticket details from those boards, so do not add boards you want to use SmileBack with to this field.
   
7. Click Save.

Creating an API Key

1. Select the API member created for SmileBack in the previous section and click the API Keys tab
2. Click + to create a new API key
3. For description enter SmileBack, then click Save
   

Entering the API Key into SmileBack

Copy and paste both the Public and Private keys you created in the previous section from ConnectWise into the API Member Authentication section in SmileBack and click Validate API Connection.

SmileBack will confirm that the correct API permissions have been given. If it's working correctly you will see green "pass" notifications. You will also see some blue "manual check required" messages, if you set the Role ID to "Admin", in Step 5 above, you can ignore this. These are permissions that SmileBack cannot automatically check remotely, so if you set up a custom security member then please refer to that article and double check the permissions before continuing.

Note that since SmileBack is connected to ConnectWise through an API Key, every new ConnectWise version is compatible with SmileBack and vice versa.