Collabin mit n8n automatisieren: der offizielle Community Node

n8n-nodes-collabin ist der offizielle n8n Community Node für Collabin, Open Source auf GitHub. Er verpackt die REST API und Webhooks, die Sie sonst manuell aufrufen müssten, in fertige Nodes: Benutzer, Teams, Urlaubsarten, Urlaubsanträge und den Kalender abrufen und verwalten, sofort auf Urlaubs-Events reagieren mit eingebauter Signaturprüfung, und das Ganze sogar einem KI-Agenten als Tool übergeben. Diese Anleitung installiert den Node, verbindet ihn mit Ihrem Konto und führt Sie durch beide Nodes von Anfang bis Ende.

Was im Paket enthalten ist

Element	Typ	Was es macht
Collabin	Action Node	Lesen und Verwalten von Benutzern, Teams, Urlaubsarten, Urlaubsanträgen und dem Kalender über die `/v1` API. Kann auch als Tool eines AI Agent Node verwendet werden.
Collabin Trigger	Trigger Node	Startet den Workflow, wenn Collabin einen Webhook sendet (`leave.created`, `leave.status_changed`) — prüft den `X-Collabin-Signature` Header für Sie.
Collabin API	Credentials	Speichert Ihren API-Schlüssel und die Basis-URL der API, von beiden Nodes verwendet.

Was Sie benötigen

Ein Collabin-Konto mit Pro-Plan — die externe API und Webhooks sind Pro-Funktionen.
Admin- oder Superadmin-Berechtigung, um einen API-Schlüssel zu erstellen und (für den Trigger) einen Webhook anzulegen.
Eine selbst gehostete n8n-Instanz oder einen n8n Cloud-Plan, der die Installation von Community Nodes erlaubt — wenn Sie unsicher sind, lesen Sie die n8n-Dokumentation zu Community Nodes.

Schritt 1: Node installieren

Gehen Sie in n8n zu Settings → Community Nodes → Install.
Geben Sie n8n-nodes-collabin ein und bestätigen Sie.
Collabin und Collabin Trigger erscheinen jetzt im Node-Panel.

Schritt 2: Collabin-Konto verbinden

Gehen Sie im Collabin-Dashboard zu Settings → API Keys und erstellen Sie einen neuen Schlüssel. Wählen Sie Read, wenn Sie nur Daten abrufen möchten, oder Read & Write, wenn Sie aus n8n heraus auch Urlaubsanträge erstellen oder genehmigen/ablehnen möchten.
Kopieren Sie den Schlüssel (clb_…) — er wird nur einmal angezeigt.
Fügen Sie einem Workflow einen Collabin-Node (oder Collabin Trigger) hinzu, öffnen Sie das Credential-Dropdown und erstellen Sie ein neues Collabin API-Credential:
- API Key: der Schlüssel aus Schritt 2.
- Base URL: https://api.collabin.eu (Standardwert — unverändert lassen).
Klicken Sie auf Test. Ein erfolgreicher Test ruft GET /v1/leave-types mit Ihrem Schlüssel auf.

Schritt 3: Daten mit dem Collabin Node abrufen und verwalten

Der Collabin-Node folgt dem aus n8n bekannten Resource-→-Operation-Muster:

Resource	Operation	Hinweise
User	Get / Get Many	Get Many kann nach Name oder E-Mail gefiltert werden
User	Get Leaves	Urlaubsanträge eines Benutzers, optional nach Status gefiltert
Team	Get / Get Many	Enthält Teamleiter und Mitglieder
Leave Type	Get Many	Die Urlaubsarten Ihrer Organisation
Leave	Get / Get Many	Filterung nach Benutzer, Status, Zeitraum oder "updated since"
Leave	Create	Neuer Antrag mit Status `PENDING` — erfordert einen Schlüssel mit Schreibrecht
Leave	Update Status	Genehmigung oder Ablehnung eines `PENDING`-Antrags — erfordert einen Schlüssel mit Schreibrecht
Calendar	Get	Arbeits-/Feiertagskalender für einen Zeitraum

Zwei Dinge, die Sie kennen sollten:

Return All + Updated Since: Aktivieren Sie Return All bei jeder "Get Many"-Operation, und der Node durchläuft die API automatisch seitenweise (500 Datensätze pro Anfrage), bis alles abgerufen ist. Kombiniert mit dem Filter Updated Since bei Leave → Get Many ist das die Grundlage für eine inkrementelle Synchronisierung — ein Schedule Trigger, der stündlich läuft und nur Änderungen seit dem letzten Lauf abruft.
AI Agent Tool: Jede Operation ist auch als Tool verfügbar. Fügen Sie den Collabin-Node zu den Tools eines AI Agent Node hinzu, und der Agent kann Fragen beantworten wie "Wie viele Urlaubstage hat Jane dieses Jahr noch übrig?" — oder, mit einem Schlüssel mit Schreibrecht, Anweisungen ausführen wie "genehmige Janes Urlaubsantrag für nächste Woche".

Schritt 4: Mit dem Collabin Trigger Node auf Events reagieren

Wenn Sie unsere n8n/Make-Webhook-Anleitung gelesen haben, wissen Sie, dass die Prüfung des X-Collabin-Signature Headers normalerweise einen Code Node mit HMAC-Logik erfordert. Der Collabin Trigger Node übernimmt das für Sie — Anfragen mit ungültiger oder fehlender Signatur werden mit 401 abgelehnt, bevor Ihr Workflow überhaupt startet.

Fügen Sie einem Workflow einen Collabin Trigger-Node hinzu und kopieren Sie dessen Webhook-URL.
Gehen Sie im Collabin-Dashboard zu Settings → Webhooks und erstellen Sie einen neuen Webhook:
- URL: die n8n-Webhook-URL aus Schritt 1.
- Events: wählen Sie leave.created, leave.status_changed oder beide aus.
Collabin zeigt das Signing Secret einmalig an — kopieren Sie es in das Feld Signing Secret des Nodes.
Wählen Sie im Feld Events des Nodes dieselben Events aus. Das ist ein lokaler Filter: Alles, was Collabin sendet, aber hier nicht ausgewählt ist, wird bestätigt, startet aber den Workflow nicht.

Aktivieren Sie den Workflow, senden Sie einen Test-Urlaubsantrag in Collabin, und der Trigger feuert mit dem vollständigen Urlaubsobjekt — einschließlich des verknüpften Benutzers und der Urlaubsart — im Feld data.

Beispiel-Workflows

Slack/Teams-Benachrichtigungen — Collabin Trigger (leave.created) → ein Slack- oder Microsoft-Teams-Node, sodass Manager neue Anträge sofort sehen.
Genehmigung von überall — beliebiger Trigger (Slack-Befehl, Formular, Chatbot) → Collabin-Node (Leave → Update Status), um einen PENDING-Antrag zu genehmigen oder abzulehnen, ohne Collabin zu öffnen.
Inkrementelle Gehaltsabrechnungs-Synchronisierung — Schedule Trigger → Collabin-Node (Leave → Get Many, Updated Since = letzter Lauf, Return All) → Änderungen an Ihr Gehaltsabrechnungs- oder HRIS-System weiterleiten.
HR-Assistent — Collabin-Node als AI Agent Tool, sodass ein Chat-Assistent bei Bedarf Salden, Teams und ausstehende Anträge abrufen kann.

Gut zu wissen

Plananforderung: Sowohl die /v1 API als auch Webhooks erfordern den Pro-Plan; ein Aufruf mit einem nicht berechtigten Plan liefert 403 Forbidden.
Rate Limit: 120 Anfragen pro Minute pro API-Schlüssel — bei großen Exporten ist Return All (größere Seiten) besser als viele kleine Anfragen.
Read vs. Write: Create und Update Status benötigen einen Schlüssel mit Read & Write; alles andere funktioniert mit einem Read-Schlüssel.
Kompatibilität: erfordert Node.js 20.15+ auf der n8n-Instanz — die übliche Anforderung aktueller n8n-Versionen.

Wie es weitergeht

n8n-nodes-collabin auf npm und Quellcode auf GitHub — Issues und Contributions sind willkommen.
Neu bei der API? Starten Sie mit dem REST API Quickstart.
Bevorzugen Sie eine leichtere Webhook-Lösung ohne Installation eines Community Nodes? Lesen Sie No-Code-Automatisierungen mit n8n und Make.