Package Information
Documentation
n8n-nodes-ninjaone
Community node for n8n to interact with the NinjaOne RMM platform API.
š©šŖ Deutsche Version (README_DE.md)
Scope
122 operations across 17 resources. This node covers the ticketing, device, organization, query and system areas of the NinjaOne API. It does not implement the full API ā see Not covered below.
| Resource | Operations |
|---|---|
| Query (reports) | 25 |
| System | 18 |
| Device | 17 |
| Ticketing | 17 |
| Organization | 5 |
| User | 5 |
| Knowledge Base Article | 5 |
| Organization Document | 5 |
| Custom Field | 4 |
| Group | 3 |
| Alert | 3 |
| Location | 3 |
| Related Item | 3 |
| Software License | 3 |
| Backup | 2 |
| Webhook | 2 |
| Document Template | 2 |
Features
š« Ticketing
| Operation | Description |
|---|---|
| Create Ticket | Create a new support ticket |
| Get Ticket | Retrieve a ticket by ID |
| Get Many Tickets | List tickets from a board |
| Update Ticket | Update ticket fields (auto-fetches required fields) |
| Delete Ticket | Delete a ticket |
| Add Comment | Add a public or private comment to a ticket |
| Get / Create / Update / Delete Contact | Contact management |
| Get Boards | List available ticket boards |
| Get Ticket Forms | List ticket form templates |
| Get Statuses | List available ticket statuses |
| Get Log Entries | Retrieve ticket activity log |
| Get Ticket Attributes | List ticket attributes |
| Get Users by Type | List app user contacts by type |
š» Devices
| Operation | Description |
|---|---|
| Get / Get Many | Retrieve device details (filter by organization supported) |
| Search | Find devices by query string |
| Reboot | Remotely reboot a device (normal mode) |
| Run Script | Execute a script on a device |
| Maintenance | Set a maintenance window |
| Approve / Reject | Handle pending device approvals |
| Get Last Logged-On User | See who last used a device |
| Get Activities | Device activity history |
| Get Disks / Volumes / Processors | Hardware information |
| Get Network Interfaces | Network configuration |
| Get OS Patches / Software | Installed patches and software |
| Get / Update Custom Fields | Read and write custom field values |
š¢ Organizations
| Operation | Description |
|---|---|
| Get Many / Get / Create / Update / Delete | Organization CRUD |
| Locations | Get, create and update locations (separate resource) |
| Custom Fields | Read and update org custom fields (separate resource) |
| Documents | Create, read, update and delete organization documents |
š System & Reporting
| Operation | Description |
|---|---|
| Get Activities | Global activity log |
| Get Contacts | List all contacts |
| Get Device Custom Fields | List device custom field definitions |
| Get Device Roles | List device roles |
| Get Devices (Detailed) | List devices with full details in one call |
| Get End Users | List end users |
| Get Jobs | List active jobs |
| Get Locations | List all locations |
| Get Notification Channels | List notification channels (all / enabled) |
| Get Organizations (Detailed) | List organizations with full details |
| Get Policies | List configured policies |
| Get Scheduled Tasks | List scheduled tasks |
| Get Scripts | Available automation scripts |
| Get Scripting Languages | Supported scripting languages |
| Get Software Products | Supported third-party software |
| Get Technicians | List technicians |
| Get User Roles | List user roles |
Query reports (25): Alerts, Antivirus Status, Antivirus Threats, Backup Usage, Computer Systems, Custom Fields, Custom Fields (Detailed), Device Health, Disks, Logged-On Users, Network Interfaces, Operating Systems, OS Patch Installs, OS Patches, Policy Overrides, Processors, RAID Controllers, RAID Drives, Scoped Custom Fields, Scoped Custom Fields (Detailed), Software, Software Patch Installs, Software Patches, Volumes, Windows Services.
š Software Licenses
| Operation | Description |
|---|---|
| Get Many | List all software licenses with quantity, current usage and expiry |
| Get | Retrieve a single license by ID |
| Get Assignments | List the devices a license is assigned to |
š Additional Resources
Groups, Users, Alerts, Locations, Backup Jobs, Webhooks, Custom Fields, Knowledge Base Articles, Organization Documents, Document Templates, Related Items.
Filtering
Device-related resources (Query, Device, Alert, Backup, System) share the same filter fields. Enter plain values ā the node builds the NinjaOne device filter expression for you:
| Filter | Example input |
|---|---|
| Organization ID | 5 or 1,2,3 |
| Device ID | 123 |
| Location ID / Role ID | 12 |
| Device Classes | pick from a list |
| Online Status | Online / Offline |
| Approval Status | Approved / Pending |
Query reports additionally offer the filters their endpoint supports, for example Installed Before/After for Software, or Status, Type and Severity for OS Patches.
Authentication
| Method | Typical use | Credential name |
|---|---|---|
| OAuth2 (Authorization Code) | Write operations (create/update tickets, post comments) | NinjaOne OAuth2 API |
| Client Credentials (M2M) | Read operations (list tickets, get devices, fetch contacts) | NinjaOne Client Credentials API |
Both credentials support all four NinjaOne regions: EU, US, Oceania and Canada.
The OAuth2 credential requests the offline_access scope so refresh tokens are issued.
Installation
In n8n
- Go to Settings ā Community Nodes
- Click Install a community node
- Enter
@vaiyen_og/n8n-nodes-ninjaone - Click Install
Via npm
npm install @vaiyen_og/n8n-nodes-ninjaone
Setup
OAuth2 credential
- In NinjaOne, create an API Application (Authorization Code type)
- Set the redirect URI to your n8n OAuth callback URL
- In n8n, add a new NinjaOne OAuth2 API credential
- Enter your Client ID and Client Secret
- Select your region
- Click Connect my account and log in with the NinjaOne user account
Client Credentials credential
- In NinjaOne, create an API Application (Client Credentials type)
- In n8n, add a new NinjaOne Client Credentials API credential
- Enter your Client ID and Client Secret
- Select your region and save
The scopes granted to the API application in NinjaOne determine which operations succeed. Read-only applications cannot perform write operations.
Supported NinjaOne regions
| Region | Base URL |
|---|---|
| EU | eu.ninjarmm.com |
| US | app.ninjarmm.com |
| Oceania | oc.ninjarmm.com |
| Canada | ca.ninjarmm.com |
Not covered
The following NinjaOne API areas are not implemented: billing, checklist templates, policy conditions, installer generation, device decommissioning, patch scan/apply actions, knowledge base folder management and bulk custom field administration. Technicians, end users, scheduled tasks, notification channels and software licenses can be listed, but not created, updated or deleted.
Ticket lists from a board are returned unfiltered ā the NinjaOne board endpoint rejects filter fields. Filter the results in your workflow instead.