ninjaone

n8n community node for NinjaOne RMM – full API coverage including organizations, devices, ticketing, users, groups, queries, management, backup, locations, custom fields, webhooks, knowledge base, document templates, and more.

Package Information

Released: 7 mo ago
Downloads: 18 weekly / 181 monthly
Latest Version: 1.4.2
Author: NinjaOne n8n Community

Available Nodes

NinjaOne icon
NinjaOne
Consume the NinjaOne RMM API
NinjaOne Trigger icon
NinjaOne Trigger
Receive NinjaOne webhook events in real-time

Documentation

@vaiyen/n8n-nodes-ninjaone

Vollständige n8n Community Node für die NinjaOne RMM API (v2).
Unterstützt alle regionalen Instanzen (EU, US, OC, CA) mit OAuth2 Authorization Code und Client Credentials Authentifizierung.

Installation

  1. Öffne deine n8n-Instanz
  2. Gehe zu Settings → Community Nodes
  3. Klicke Install
  4. Gib @vaiyen/n8n-nodes-ninjaone ein
  5. Bestätige die Installation

Authentifizierung

Option 1: OAuth2 Authorization Code (für Ticket-Erstellung mit User-Kontext)

  1. In NinjaOne: Administration → Apps → API → Client App IDs → Add
  2. Plattform: Web
  3. Wähle Authorization Code und Refresh Token als Grant Types
  4. Scopes: monitoring, management, control
  5. Redirect URI: https://<dein-n8n>/rest/oauth2-credential/callback
  6. In n8n: Neue Credential erstellen → NinjaOne OAuth2 API
  7. Toggle auf OAuth2 (Authorization Code)
  8. Trage Client ID, Client Secret ein und wähle die Region
  9. Klicke Connect zum Autorisieren

Option 2: Client Credentials / Machine-to-Machine (für Kontakte, Lesen, etc.)

  1. In NinjaOne: Administration → Apps → API → Client App IDs → Add
  2. Plattform: Machine-to-Machine
  3. Scopes: monitoring, management, control
  4. In n8n: Neue Credential erstellen → NinjaOne OAuth2 API
  5. Toggle auf Client Credentials
  6. Trage Client ID, Client Secret ein und wähle die Region
  7. Klicke Save

Wann welche Credential?

  • OAuth2 Authorization Code → Tickets erstellen/bearbeiten (braucht User-Kontext)
  • Client Credentials → Kontakte lesen/erstellen, Devices auflisten, alles was keinen User-Kontext braucht

Du kannst beide Credentials im selben Workflow verwenden – einfach pro Node die passende auswählen.

Unterstützte Ressourcen & Operationen

Organization

  • Create, Get, Get Many, Update, Delete

Device

  • Get, Get Many (mit Device Filter Syntax)
  • Get Activities, Custom Fields, Disks, Network Interfaces, OS Patches, Processors, Software, Volumes
  • Approve/Reject, Reboot, Run Script, Maintenance Mode
  • Update Custom Fields

Ticketing

  • Create Ticket, Get Ticket, Get Many (per Board ID), Update, Delete
  • Create Contact, Get Contacts
  • Add Comment, Get Log Entries
  • Get Boards, Statuses, Ticket Forms

User

  • Create, Get, Get Many, Update, Delete

Group

  • Get, Get Many, Get Device IDs

Query (Bulk-Abfragen)

  • Alerts, Antivirus Status, Antivirus Threats, Custom Fields
  • Device Health, Disks, Network Interfaces
  • OS Patches, OS Patch Installs, Processors
  • RAID Drives, Software, Software Patches, Windows Services

Alert

  • Get Many, Reset, Reset with Activity Data

Location

  • Create, Get Many, Update

Backup

  • Get Backup Jobs, Get Integrity Check Results

Webhook

  • Configure (Create/Update), Delete

Custom Field

  • Get/Update Device Custom Fields
  • Get/Update Organization Custom Fields

Knowledge Base Article

  • Create, Get, Get Many, Update, Delete

Organization Document

  • Create, Get, Get Many, Update, Delete

Document Template

  • Get, Get Many

Related Item

  • Create, Get Many, Delete

Trigger Node

Der NinjaOne Trigger Node empfängt Webhook-Events in Echtzeit:

  • Alert Triggered/Reset
  • Condition Triggered/Reset
  • Device Added/Deleted/Online/Offline/Approval
  • Patch Management
  • Script Run
  • Ticket Created/Updated/Deleted

Device Filter Syntax

Viele Endpoints unterstützen die NinjaOne Device Filter Syntax (Parameter df), z.B.:

class in (WINDOWS_WORKSTATION, WINDOWS_SERVER)
org = 1
status = ONLINE

Siehe NinjaOne Device Filter Dokumentation.

API Regionen

Region Base URL
EU https://eu.ninjarmm.com
US https://app.ninjarmm.com
Oceania https://oc.ninjarmm.com
Canada https://ca.ninjarmm.com

Lizenz

MIT

Links

Discussion