Already a NinjaOne customer? Log in to view more guides and the latest updates.

ConnectWise Manage REST API Key Setup Guide

Topic

This guide will show you the steps to create a ConnectWise API Member to activate the ConnectWise – NinjaOne Integration.

Environment

  • NinjaOne Integrations
  • ConnectWise Manage

Description

To integrate ConnectWise Manage and NinjaOne, you must provide an API key during setup. For more information, refer to NinjaOne Integrations: Getting Started with ConnectWise Manage.

Index

Select a category to learn more:

Create a Security Role for API User Permissions

Create a new security role to use for your API user that grants them permission only to the assets that are necessary for NinjaOne's ConnectWise integration.

  1. Open the System menu and select Security Roles.
CW_system_security roles.png
Figure 1: Access security roles in ConnectWise Manage
  1. Create a new role by clicking the plus sign icon (+) at the top of the Security Roles table.
CW_new role.png
Figure 2: Add a new security role in ConnectWise
  1. Give the role a unique identifier and save to continue. The page will update to show security modules for the role.
  2. For all categories except the ones described in the following table, select None from the drop-down menus.
Category nameModule levelAccess required
Companies → Company MaintenanceInquireAll
Comanies → ConfigurationsAdd, Edit, and InquireAll
Companies → ContactsAdd, InquireAll
Finance → AgreementsAdd, Edit, InquireAll
Procurement → Product CatalogInquireAll
Procurement → ProductsInquireAll
Service Desk → Close Service TicketsAdd, Edit, InquireAll
Service Desk → Service TicketsAdd, Edit, InquireAll
Service Desk → SLA DashboardInquireAll
System → Table Setup*Add, Edit, InquireAll
CW_security modules.png
Figure 3: Configure security modules for the new security role
The permissions for SystemTable Setup are nested. To select the nested permissions, click the blue customize hyperlink next to Table Setup after expanding the System options.
  1. Click the customize hyperlink next to System Table Setup. Move the following items from the Allow access to these box into the Disallow access to these box:
    • Contacts / Communication Type
    • General / StsClient
crowdstrike_customize settings.png
Figure 4: Update security for table settings
crowdstrike_update security dialog.png
Figure 5: Update security dialog

Create the API User

Create the API user to facilitate the connection between NinjaOne and ConnectWise.

  1. From System in the main navigation, click Members and then open the API Members tab when the Members page opens.
CW_members_api members.png
Figure 6: Access the API Members page in ConnectWise
  1. Create a new API member by clicking the plus sign icon (+).
  2. You will be prompted to create a new user. Make sure the Role ID is set to the new security role that you created earlier in this process.
CW_api member_role id_RMM.png
Figure 7: Set the role ID for the API user

You must complete other required fields before you can save the new user. Except for the fields mentioned above, you can fill in the fields to your preference.

Add the API Key

NinjaOne will request a public and private API key when enabling the integration. Perform the following steps to obtain the keys:

  1. On the new API Member page, open the API Keys tab and then click the plus sign icon (+) to add an API key.
CW_api member_api keys_new.png
Figure 8: Create a new API key
  1. Add a description for the Public API Key, and when ready, click the save icon.
  2. Copy the Public and Private Key to paste into NinjaOne where applicable. This is the only time you will see the Private Key, so please save it.
CW_public api key.png
Figure 9: Copy the API key data

Additional Resources

We offer the following resources to help optimize the integration between your NinjaOne and ConnectWise Manage accounts:

FAQ

Next Steps