n8n-nodes-ninjaone

Community node for n8n to interact with the NinjaOne RMM platform API.

🇩🇪 Deutsche Version (README_DE.md)

Features

Full API coverage for NinjaOne RMM with 60+ operations across all major resources.

🎫 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 | Full 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 all custom ticket attributes | | Get Users by Type | List technicians and contacts |

💻 Devices

| Operation | Description | |-----------|-------------| | Get / Get Many | Retrieve device details | | Search | Find devices by name or criteria | | Reboot | Remotely reboot a device | | Run Script | Execute a script on a device | | Maintenance | Set maintenance windows | | 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 All / Get One / Create / Update | Full organization CRUD | | Locations | Get, create, and update locations | | Custom Fields | Read and update org custom fields | | End Users | List end users per organization | | Backup Usage | View backup consumption | | Documents | Create organization documents |

📊 System & Reporting

| Operation | Description | |-----------|-------------| | Activities | Global activity log | | Alerts | Active alert conditions | | Policies | List configured policies | | Software Products | Supported third-party software | | Scripts | Available automation scripts | | Queries | Antivirus, OS patches, disk health, and more |

🔗 Additional Resources

Groups, Users, Locations, Backup Jobs, Webhooks, Custom Fields, Knowledge Base Articles, Organization Documents, Document Templates, Related Items

Authentication

This node supports two authentication methods:

| Method | Use Case | 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.

Tip: The OAuth2 credential includes offline_access scope for persistent refresh tokens.

Installation

In n8n

1. Go to Settings → Community Nodes
2. Click Install a community node
3. Enter @vaiyen_og/n8n-nodes-ninjaone
4. Click Install

Via npm

npm install @vaiyen_og/n8n-nodes-ninjaone

Setup

OAuth2 Credential

1. In NinjaOne, create an API Application (Authorization Code type)
2. Set the redirect URI to your n8n OAuth callback URL
3. In n8n, add a new NinjaOne OAuth2 API credential
4. Enter your Client ID and Client Secret
5. Select your region
6. Click Connect and log in with the NinjaOne user account

Client Credentials

1. In NinjaOne, create an API Application (Client Credentials type)
2. In n8n, add a new NinjaOne Client Credentials API credential
3. Enter your Client ID and Client Secret
4. Select your region
5. Click Connect

Supported NinjaOne Regions

| Region | Base URL | |--------|----------| | EU | eu.ninjarmm.com | | US | app.ninjarmm.com | | Oceania | oc.ninjarmm.com | | Canada | ca.ninjarmm.com |

License

MIT