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

Getting Started with Autotask Integration

Topic

This guide provides instructions for enabling and configuring the Autotask integration with NinjaOne.

Environment

  • NinjaOne Integrations
  • Autotask

Description

NinjaOne can automatically sync your devices and their roles with the Autotask Professional Services Agreement (PSA) tool, enabling you to share hardware details, device specifications, and more between the platforms. You can even allow a quick-access link to NinjaOne within Autotask. 

Alerts from NinjaOne sync directly to Autotask tickets, and you can customize your helpdesk experience by choosing different service boards, priorities, and statuses. When you reset a NinjaOne alert, it will close the corresponding ticket in Autotask, and the same applies when closing tickets in Autotask.

Integrations: Enabling the Autotask Integration (NinjaOne Inc. 03;08)

Select a topic to continue.

Autotask User-Defined Field Requirement

NinjaOne requires a User-Defined Field (UDF) in Autotask, which you must create manually. If you do not provide a UDF, ticket creation may fail. Follow these steps to create the account and UDF. To learn more about creating these fields, refer to Autotask documentation: REST API: User-defined fields (UDFs) (external link).

Set Up the User Account

To integrate Autotask with NinjaOne, you must first create an API User account in Autotask with an API tracking identifier that corresponds with the correct vendor.

  1. On your Autotask instance's home page, navigate to Admin → Resources (Users).
1.gif
Figure 1: Admin → Resources (Users) (click to enlarge)
  1. Place your mouse over the New button and select New API User.
2.gif
Figure 2: New → New API User (click to enlarge)
  1. The Add API User window will open. In the Security Level drop-down menu, select API User (system). Complete all fields in the General section of the page.
Figure 3: API User configuration (click to enlarge)
  1. In the Credentials section, click Generate Key, then click Generate Secret and save the resulting credentials. You will enter them into NinjaOne in the Enabling the Autotask Integration section of this article.
Figure 4: Generating credentials (click to enlarge)

Set Up the API Tracking Identifier

To configure the API Tracking Identifier section, perform the following steps:

  1. Navigate to the API Tracking Identifier section of the page and ensure that the Integration Vendor radio button is selected. Then, select NinjaRMM - RMM from the Integration Vendor drop-down menu.
Figure 5: Integration Vendor (click to enlarge)

2. In the Line of Business section of the page, select the line of business in the Not Associated pane, then click the arrow to move it to the Associated pane. When finished, click Save & Close.

Figure 6: Adding Line of Business (click to enlarge)

Grant Data Permission

To add permissions, perform the following steps:

  1. Click the back button next to the Resources page title to return to the Admin page.
Figure 7: Return navigation (click to enlarge)
  1. Navigate to Account Settings & UsersResources/Users (HR).
Figure 8: Account Settings & Users → Resources/Users (HR) (click to enlarge)
  1. In the Security section, click Protected Data Permission.
Figure 9: Admin → Security → Protected Data Permission (click to enlarge)
  1. Grant the user full permissions and then click Save.
Figure 10: Assigning permissions (click to enlarge)

Activating and Connecting the Autotask Integration

After setting up he user account, follow these steps to activate the Autotask integration in NinjaOne and connect it to Autotask.

Activating the Autotask Integration

If you generated a user in Autotask but did not click Save & Close, the credentials may not work.
  1. In NinjaOne, navigate to Administration Apps, then click Add app and select Autotask PSA from the list. NinjaOne will prompt you to confirm the addition.
EnableAutotask_AddApps.png
Figure 11: Administration → Apps → Add app (click to enlarge)
  1. The integration will appear on the dashboard, reporting a Not connected status. Click Enable.
Figure 12: Enable integration (click to enlarge)
  1. Input the Username (Key) and Password (Secret) values of the Autotask API User account you created.
  2. Click Test to ensure that NinjaOne can communicate with your Autotask instance. If the configuration is successful, you'll receive a confirmation stating, "Status: Connection succeeded with provided credentials." On the integration's Connection page, the status will read 'Healthy'.
Figure 13: Successful integration configuration (click to enlarge)
  1. Click Save to store the configuration.

Viewing Autotask Connection Status

When the Autotask API user is able to connect, NinjaOne shows the status as "Healthy." If the API user is locked or was deactivated after connection, the Status displays as "Unhealthy." (Place your cursor over the (i) tooltip for more detailed information.) When your Autotask Status is "Unhealthy," the application will not perform calls to the API or will return an error.

Figure 14: Autotask connection status (click to enlarge)

Troubleshooting an Unhealthy Autotask Connection

If you are experiencing issues with the Autotask connection, perform the following steps for resolution.

  1. Open the API user account in Autotask and verify that the Active checkbox is selected and the Locked checkbox is not selected.
Figure 15: API User activation controls (click to enlarge)
  1. If you do not have the Password (Secret) saved, generate a new one and copy it.
  2. Click Save & Close.
  3. In NinjaOne, click Edit and reenter the username (email address) and password (Secret) for your Autotask API user account, then click Test to ensure that the credentials are properly resolved.
  4. If the connection succeeds, click Save. The Status should now display "Healthy."

Additional Resources

Refer to Autotask – NinjaOne Dojo to learn more about using Autotask with NinjaOne.

FAQ

Next Steps