Directus + n8n: End-to-End-Integration mit dem offiziellen Node

Directus und n8n gehören aktuell zu den spannendsten Open-Source-Plattformen für die Digitalisierung von Geschäftsprozessen.

Während Directus Datenmodelle, APIs, Benutzerverwaltung und Berechtigungen bereitstellt, übernimmt n8n die Automatisierung und Integration zwischen verschiedenen Systemen.

Die Kombination beider Plattformen ermöglicht den Aufbau leistungsfähiger Integrationsarchitekturen ohne individuelle Middleware-Entwicklung.

Besonders interessant wird die Verbindung von Directus und n8n für Unternehmen, die Daten zentral verwalten und gleichzeitig Prozesse über CRM-, ERP-, Service- oder Kommunikationssysteme automatisieren möchten.

In diesem Tutorial zeigen wir Schritt für Schritt:

• Installation des offiziellen Directus n8n Nodes
• Einrichtung der Credentials
• Directus Actions und Trigger
• Typische Fehlerquellen
• Ein vollständiges Praxisbeispiel mit Slack und HubSpot
• Wann Directus Flows besser geeignet sind als n8n

Wann sich die Kombination aus Directus und n8n lohnt

Viele Teams versuchen heute, möglichst viele Prozesse in einem einzigen System abzubilden.

In der Praxis funktioniert eine klare Aufgabenteilung meist deutlich besser.

Directus als Daten-Plane, n8n als Workflow-Engine

Eine bewährte Architektur sieht folgendermaßen aus:

Directus übernimmt

• Datenmodellierung
• APIs
• Benutzerverwaltung
• Rollen und Berechtigungen
• Dateiverwaltung
• Datenqualität

n8n übernimmt

• Prozessautomatisierung
• Integrationen
• Benachrichtigungen
• KI-Workflows
• Datensynchronisation

Diese Trennung sorgt für eine deutlich bessere Wartbarkeit.

Typische Use Cases

Die Directus n8n Integration eignet sich besonders für:

CRM-Synchronisation

• HubSpot
• Salesforce
• Pipedrive

ERP-Integrationen

• SAP
• Business Central
• Microsoft Dynamics

Benachrichtigungen

• Slack
• Microsoft Teams
• E-Mail

KI-Anwendungen

• OpenAI
• Claude
• Dokumentenanalyse

Kundenportale

• Ticketanlage
• Bestellverarbeitung
• Dokumentenfreigaben

 

Directus oder n8n – was macht welches System?

Eine der häufigsten Fehlentscheidungen besteht darin, n8n als Datenplattform oder Directus als Workflow-Engine zu verwenden.

Beide Systeme wurden für unterschiedliche Aufgaben entwickelt.

Für die meisten Projekte lautet die optimale Architektur:

Directus speichert und verwaltet Daten. n8n verarbeitet und verteilt sie.

 

Installation des offiziellen Directus n8n Nodes

Die Verbindung erfolgt über den offiziellen Directus Node.

Über die n8n-Knotenpalette suchen

Der wichtigste Hinweis vorweg:

Suche den Node immer über die integrierte Node-Suche von n8n.

Pfad: Add Node → Search → Directus

Verification-Badge prüfen

Achte unbedingt auf den Verification Badge.

Dieser bestätigt, dass es sich um den offiziellen Node handelt.

Wichtiger Hinweis:

Der Badge erscheint nur bei Installation über die Knotenpalette.

Bei manueller Paketinstallation fehlt die Kennzeichnung häufig.

Das führt regelmäßig zu Verwechslungen mit Community-Erweiterungen.

Self-Hosted oder n8n Cloud

Der Directus Node funktioniert in beiden Varianten.

n8n Cloud

Vorteile:

• Kein Betrieb
• Sofort einsatzbereit
• Automatische Updates

Self-Hosted n8n

Vorteile:

• Volle Kontrolle
• Eigene Infrastruktur
• Keine Workflow-Limits

Für viele Directus-Projekte wird Self-Hosting bevorzugt.

 

Credentials einrichten

Nach der Installation erfolgt die Verbindung zu Directus.

Admin-Token oder statisches Token

Directus unterstützt verschiedene Authentifizierungsmodelle.

Für die meisten Workflows reicht ein statisches API-Token.

Erstellung in Directus: Settings → API Tokens

Wichtiger Hinweis zu Triggern

Viele Entwickler scheitern bei den ersten Triggern.

Grund:

Webhook-basierte Trigger benötigen häufig weitergehende Berechtigungen.

Insbesondere bei:

• Collection Webhooks
• User Events
• System Events

ist häufig ein Admin-Token erforderlich.

Dies gehört zu den häufigsten Fehlerquellen bei der Directus n8n Integration.

URL-Konfiguration

Beispiel: https://directus.example.com

Empfehlungen:

• HTTPS verwenden
• Kein Slash am Ende
• Öffentliche Erreichbarkeit sicherstellen

Verbindung testen

Nach dem Speichern sollte die Testfunktion erfolgreich sein.

Typische Fehler:

• Falsches Token
• Fehlende Rechte
• Firewall
• Reverse Proxy Fehler
• Falsche URL

 

Directus Actions in n8n

Der Directus Node unterstützt zahlreiche Standardoperationen.

Items: Create, Read, Update, Delete und Bulk

Der wichtigste Bereich ist die Arbeit mit Collections.

Unterstützt werden:

Create

Datensatz erstellen

Read

Datensätze lesen

Update

Datensätze ändern

Delete

Datensätze löschen

Bulk

Mehrere Datensätze gleichzeitig verarbeiten

Damit lassen sich nahezu alle Directus Collections automatisieren.

 

Users

Der Node unterstützt die Benutzerverwaltung.

Typische Anwendungsfälle:

• Benutzer anlegen
• Rollen vergeben
• Konten aktualisieren

 

Files

Dateiverwaltung direkt über n8n.

Mögliche Aktionen:

• Upload
• Download
• Metadaten ändern
• Dateien löschen

 

Generic API Call

Nicht jede Directus-Funktion besitzt eine eigene Node-Aktion.

Deshalb unterstützt der Node generische API-Aufrufe.

Vorteile:

• Vollständige REST API nutzbar
• Neue Directus Features sofort verwendbar
• Keine Abhängigkeit vom Node Release-Zyklus

 

Directus Trigger in n8n

Neben Aktionen unterstützt der Directus Node verschiedene Trigger.

Webhook-basierter Trigger

Dies ist die bevorzugte Variante.

Ablauf:

Directus
↓
Webhook
↓
n8n Trigger
↓
Workflow

Vorteile:

• Sofortige Ausführung
• Echtzeitverarbeitung
• Geringe Serverlast

 

Polling Trigger

Alternativ kann n8n regelmäßig Daten abfragen.

Ablauf:

Directus
↓
Polling
↓
Änderung erkannt
↓
Workflow startet

Nachteile:

• Höhere API-Last
• Zeitverzögerung
• Schlechtere Skalierbarkeit

 

Wann welcher Trigger sinnvoll ist

Szenario	Empfehlung
Kundenportal	Webhook
CRM-Synchronisation	Webhook
Support-System	Webhook
Legacy-Systeme	Polling
Systeme ohne Events	Polling

In den meisten Fällen sollte ein n8n Directus Trigger auf Webhooks basieren.

 

Vollständiges Beispiel-Workflow

Neuer Kontakt in Directus → Slack + HubSpot

Ein typischer Vertriebsprozess:

Sobald ein neuer Kontakt in Directus angelegt wird:

1. Kontakt in HubSpot erzeugen
2. Vertriebsteam in Slack informieren

 

Schritt 1: Collection anlegen

Collection: Contacts

Felder:

• firstname
• lastname
• email
• company

 

Schritt 2: Directus Trigger

Node: Directus Trigger
Event: Item Created
Collection: Contracts

 

Schritt 3: HubSpot Integration

Node: Create Contact

Zuordnung:

Directus	HubSpot
firstname	firstname
lastname	lastname
email	email
company	company

 

Schritt 4: Slack Benachrichtigung

Neuer Lead wurde angelegt:

Max Mustermann
Muster GmbH
max@example.com

Ergebnis

Jeder neue Kontakt wird automatisch:

• im CRM angelegt
• im Vertrieb kommuniziert
• dokumentiert

ohne manuellen Aufwand.

 

Wann Directus Flows besser sind als n8n

Eine wichtige Architekturfrage lautet:

Soll ich einen Directus Flow oder einen n8n Workflow verwenden?

Viele Teams bauen zu viel Logik in n8n.

Das führt häufig zu unnötiger Komplexität.

Directus Flows verwenden für

• Statuswechsel
• Validierungen
• Datenanreicherung
• Berechnungen
• Interne Benachrichtigungen

n8n verwenden für

• CRM-Integrationen
• ERP-Anbindungen
• KI-Prozesse
• Externe APIs
• Mehrstufige Workflows

Die praktische Heuristik

Wenn der Prozess ausschließlich innerhalb von Directus stattfindet:

→ Directus Flow

Wenn mehrere Systeme beteiligt sind:

→ n8n Workflow

Diese Regel reduziert Komplexität erheblich.

 

Fehlerbehandlung und Beobachtbarkeit

Produktive Workflows benötigen Monitoring.

Workflow-Ausführungen analysieren

n8n speichert:

• Eingabedaten
• Ausgabedaten
• Fehlermeldungen
• Laufzeiten

Dadurch lassen sich Fehler schnell identifizieren.

Retry-Strategien verwenden

Empfohlen:

• Automatische Wiederholung
• Exponentielles Backoff
• Fehler-Queues

 

Alerts einrichten

Benachrichtigungen bei Fehlern:

• Slack
• Teams
• E-Mail

Gerade bei CRM- und ERP-Integrationen ist dies unverzichtbar.

 

Referenzarchitektur: Directus + n8n

Eine typische Unternehmensarchitektur sieht wie folgt aus:

Directus
↓
Webhook Trigger
↓
n8n Workflow
↓
HubSpot
SAP
Slack
OpenAI
Microsoft Teams

Directus bleibt die zentrale Datenplattform.

n8n übernimmt sämtliche Integrationen und Prozessabläufe.

Dadurch entsteht eine saubere und skalierbare Architektur.

 

Fazit

Die Directus n8n Integration verbindet zwei der leistungsfähigsten Open-Source-Plattformen für moderne Geschäftsanwendungen.

Directus übernimmt:

• Datenmodellierung
• APIs
• Benutzerverwaltung
• Berechtigungen

n8n übernimmt:

• Integrationen
• Automatisierungen
• Benachrichtigungen
• KI-Workflows

Besonders erfolgreich ist die Kombination dann, wenn beide Systeme für ihre jeweiligen Stärken eingesetzt werden.

Wer Directus als zentrale Datenplattform und n8n als Workflow-Engine nutzt, erhält eine flexible Integrationsarchitektur ohne Vendor Lock-in.

Sie fragen sich, ob Directus oder n8n die wichtigere Plattform in deiner Architektur sein sollte? Im diesem Beitrag vergleichen wir beide Ansätze im Detail.

FAQ

Brauche ich n8n Cloud oder reicht Self-Hosted?

Für die meisten Projekte reicht Self-Hosted vollständig aus. Die Cloud-Version reduziert den Betriebsaufwand.

Warum sehe ich keinen Verification-Badge?

Der Badge erscheint nur zuverlässig, wenn der Directus Node über die integrierte Knotenpalette installiert wird.

Wann ist ein Flow in Directus besser als ein Workflow in n8n?

Wenn der Prozess ausschließlich innerhalb von Directus abläuft, sind Directus Flows meist die bessere Wahl. Sobald externe Systeme beteiligt sind, empfiehlt sich n8n.

Wie debugge ich fehlschlagende n8n-Workflows?

Nutze die Ausführungsprotokolle von n8n. Dort werden sämtliche Eingaben, Ausgaben und Fehler detailliert protokolliert.

Benötige ich ein Admin-Token für Trigger?

Häufig ja. Besonders Webhook- und Event-basierte Trigger benötigen weitergehende Rechte als normale CRUD-Operationen.

Unterstützt der Directus Node CRUD-Operationen?

Ja. Create, Read, Update, Delete sowie Bulk-Operationen werden vollständig unterstützt.