Avec Chaleur · Technische Analyse · Feb 2026

API-Realität &
Tool-Stack

Was können Leapsome und Personio wirklich — und wie sieht der technische Stack für die Automatisierung aus?

Kernbefund nach API-Analyse
Die Verbindung existiert bereits — sie wird nur nicht genutzt
Leapsome und Personio haben eine native bidirektionale Integration. Personio ist die Datenquelle (Gehalt, Name, Adresse, Gesellschaft), Leapsome liest diese Daten automatisch ein — alle 6 Stunden. Die Personio API v2 erlaubt außerdem das programmatische Erstellen von Compensation-Einträgen und das Hochladen von Dokumenten. Das bedeutet: Der Prozess kann auf 1 menschliche Entscheidung reduziert werden — alles andere ist automatisierbar.
Was die APIs wirklich können
Leapsome API
  • Review-Daten per Content API auslesen (GET)
  • Completion-Timestamps abrufbar (wann signiert)
  • Notizfelder aus Reviews auslesbar
  • SCIM API für User-Daten (inkl. Gesellschaft)
  • Kein nativer Webhook bei Notiz-Befüllung
  • Kein Write-Back in Reviews per API
Personio API v2
  • GET employee: Name, Adresse, Gehalt, Gesellschaft
  • POST /v2/compensations: Gehaltsänderung anlegen
  • POST /v1/company/documents: PDF hochladen
  • Webhooks: employee.updated, employment.started
  • fix_salary per PATCH-Employee nicht schreibbar (nur v2/compensations)
  • Salary-Sync Personio→Leapsome muss manuell aktiviert werden
~
Leapsome Compensation
  • Eigenes Compensation-Modul mit Approval-Workflow
  • Verknüpfung mit Review-Ergebnissen möglich
  • Proposals mit strukturierter Freigabe durch Führungskraft
  • Nach Freigabe: neues Gehalt muss manuell in Personio übertragen werden (kein Auto-Sync zurück)
  • Komplett neuer Prozess — erfordert Umstieg
n8n (Orchestrierung)
  • Native Leapsome + Personio Nodes
  • Self-hosted: volle Datenkontrolle
  • Scheduled polling (ersetzt fehlenden Webhook)
  • Docx-Generierung direkt in Workflow
  • Approval per E-Mail / Slack mit Callback
  • Günstig: ~20€/mo self-hosted
Tool-Stack · Warum nur n8n
n8n
n8n — Orchestrierung des gesamten Prozesses
Steuert alle API-Calls, das Polling, die Dokumentengenerierung und den Approval-Flow. Self-hosted auf eurem Server oder VPS (~20€/mo). Keine Daten verlassen eure Infrastruktur. Einmal aufgebaut, läuft es ohne Wartung.
Leapsome API
Content API — Review-Daten auslesen
API-Token unter Settings → Integrations → API Access generieren. n8n pollt täglich. Kein Webhook nötig, täglicher Rhythmus reicht für diesen Prozess.
Personio API
v1 + v2 API — Lesen, Schreiben, Hochladen
v1: Mitarbeiterdaten lesen, Dokument hochladen. v2: Compensation anlegen. OAuth2 Credentials unter Settings → Integrations → API. Wichtig: Salary-Felder in den API Credentials explizit freischalten.
Docxtemplater
Dokumentengenerierung — Word-Vorlagen befüllen
Bestehende Word-Vorlagen werden einmalig mit Platzhaltern versehen ({{name}}, {{gehalt_neu}} etc.). n8n befüllt sie per Node automatisch und konvertiert zu PDF. Kein neues Tool — nur eine angepasste Vorlage.
Slack / Mail
Approval-Kanal — strukturierte Freigabe
Entweder per E-Mail mit Approval-Link (n8n built-in) oder per Slack mit Ja/Nein-Button. Die Entscheidung sollte davon abhängen, was Harald täglich nutzt.
Offene Fragen vor Umsetzung
Nächster Schritt: Diese offenen Fragen klären, dann kann der n8n-Workflow direkt gebaut werden. Der Aufwand für die initiale Einrichtung liegt realistisch bei 1–2 Tagen.