NinjaOne API Guide

NinjaOne consolidates asset and software data across managed devices via its Asset Inventory system. The relevant information for SIM is found in:

• Devices – Contains device and hostname information.
• Installed Applications – Lists software applications, including version and publisher details.

There are now three supported ways to get this data into SIM. We recommend the direct API integration, which lets SIM pull data from NinjaOne automatically with no manual exports.

Prerequisites

Before you begin, ensure the following:

• You have System Administrator access in NinjaOne (required to create a client app under Apps → API).
• Devices are actively reporting and have recent inventory data.
• For manual exports: access to the Reports section.
• (Optional) A working knowledge of PowerShell or command-line tools if using the custom export method.

Option 1: Direct API Integration (Recommended)

This is the standard method. You create a read-only API credential in NinjaOne and paste it into the SIM integration tab. SIM then connects directly to your NinjaOne instance and keeps the software inventory up to date automatically.

Step 1 – Create a client app in NinjaOne

1. Sign in to NinjaOne as a System Administrator.
2. Go to Administration.
   
   
3. Open Apps → API.
   
4. On the Client app IDs tab, click + Add client app.
5. Configure the client app as follows:
   

1. Click Add.

Notes:

• Monitoring is the read-only scope. It's all SIM needs to read device and software inventory — no Management or Control access is required.
• The Redirect URIs field may appear required until you deselect Authorization code. Since only Client credentials is selected, no redirect URI is needed.

Step 2 – Copy the Client ID and Client Secret

After you click Add, NinjaOne displays the Client ID and Client Secret.

• ⚠️ The Client Secret is shown only once. Copy it immediately and store it somewhere secure.
• The Client ID remains available afterwards in the Client app IDs list.

Step 3 – Find your NinjaOne instance URL

Licenseware needs to know which regional NinjaOne instance to connect to. This is the base URL shown in your browser's address bar while you're signed in to NinjaOne — sometimes called the geolocation URL. It will be one of:

The integration must use the same regional host as your console. If you pick the wrong region, the connection will fail.

Step 4 – Enter the credentials in Licenseware

1. In Licenseware, select the integration tab and the NinjaOne tile.
2. Enter:
   • Instance URL – your NinjaOne instance from Step 3
   • Client ID – from Step 2
   • Client Secret – from Step 2
3. Save / connect.

Once connected, SIM authenticates to NinjaOne using the client credentials and pulls device and installed-application data directly. The following fields are mapped automatically:

Option 2: Manual export from the NinjaOne console

Use this method for a one-off import, or where you can't create an API client app.

1. Log into the NinjaOne Admin Console.
2. Navigate to Reports → Assets → Installed Applications.
3. Use the filter options to include all devices (or a specific subset as required).
4. Click Generate Report.
5. Once the report is displayed, click Export → CSV.
6. Save the file (e.g., NinjaOne_SIM_Export.csv).

Ensure the following columns are present in your export:

See SIM template guide for further details for manual ingestion.