Webhooks: Daten automatisch an andere Systeme senden
Mit einem Webhook schickt festiware Daten automatisch an ein anderes System, sobald sich in festiware etwas ändert. So landet eine neue Person direkt in deiner Tabelle, eine bezahlte Bestellung in deiner Buchhaltung oder eine Schichtänderung in deinem Chat, zum Beispiel über n8n, Make oder Google Apps Script.
Ein Webhook legt fest, wohin die Daten gehen. Ein Trigger legt fest, wann sie gesendet werden. Trigger gehören immer zu einem Projekt. Ein Webhook gilt für alle Projekte deiner Instanz, es sei denn, er wurde über die API für ein Projekt angelegt. Für welche Projekte er gilt, zeigt das Feld Projekt.
Voraussetzungen
- Du brauchst die Berechtigung, Webhooks zu bearbeiten oder vollständig zu verwalten. Welche Rolle das umfasst, steht unter Rollen und Berechtigungen.
- Du hast eine Adresse (URL), die Daten per POST annimmt, zum Beispiel einen Webhook-Knoten in n8n.
- Verlangt der Empfänger einen Schlüssel oder ein Token, hältst du ihn bereit.
Einen Webhook anlegen
- Öffne Einstellungen › Alle Einstellungen und wähle in der Kachel Personen & Gruppen den Eintrag Webhooks.
- Klicke auf Erstelle Webhook.
- Gib einen Namen ein, unter dem du den Webhook später im Trigger wiederfindest.
- Trage unter URL die Adresse des Empfängers ein.
- Lass Aktiv eingeschaltet. Ein inaktiver Webhook sendet nichts, auch nicht über Trigger, die ihn bereits verwenden.
- Braucht der Empfänger einen Schlüssel, trägst du ihn unter HTTP-Header ein. Welcher Name dort hingehört (zum Beispiel
Authorizationmit dem WertBearer <token>oderX-API-TOKEN), steht in der Dokumentation des Empfängers. - Speichere den Webhook.

Damit kennt festiware das Ziel. Gesendet wird erst, wenn ein Trigger den Webhook aufruft.
Den Webhook mit einem Trigger auslösen
- Öffne Einstellungen › Alle Einstellungen › Personen & Gruppen › Trigger und klicke auf Erstelle Trigger.
- Wähle als Auslöser den Eintrag Bei Ereignis.
- Wähle unter Auf Ressourcentyp, um welche Daten es geht, zum Beispiel Person, Gruppe oder Bestellung.
- Wähle als Aktion den Eintrag Webhook aufrufen.
- Wähle unter Auslösendes Ereignis, wann gesendet wird: beim Erstellen, Aktualisieren oder Löschen.
- Wähle unten unter Webhook deinen Webhook aus und speichere den Trigger.
Bei Bedarf grenzt du mit Bedingungen ein, welche Datensätze gesendet werden, oder sendest mit einer Verzögerung (Minuten) später.

Trigger an Workflow-Schritten rufen einen Webhook auf, wenn eine Person oder Gruppe in einen Schritt eintritt oder ihn verlässt. Wie Trigger grundsätzlich funktionieren, erklärt Workflows und Trigger; wie du sie an Bedingungen knüpfst, steht in Trigger nur unter Bedingungen auslösen.
Ab jetzt sendet festiware bei jedem passenden Ereignis die Daten an deinen Empfänger.
Welche Daten ankommen
festiware sendet die Daten als JSON per POST. Der Aufbau ist immer gleich:
{
"event": "person.updated",
"timestamp": "2026-06-12T14:03:22+02:00",
"triggered_by": { "source": "system", "user_email": null },
"data": { … }
}
eventnennt den Ressourcentyp und das Ereignis, zum Beispielorder.createdoderperson.deleted.dataenthält den vollständigen Datensatz, bei Personen auch die Felder aus deinen Formularen.- Zusätzlich kommen Kopfzeilen mit, die dein Empfänger auswerten kann, darunter
X-Event-Type,X-Resource-TypeundX-Instance-Name.
Wie die Daten für deinen Webhook genau aussehen, zeigt dir die Detailansicht des Webhooks unter Standard-Nutzlast, sobald ein Trigger ihn verwendet. Welche Ressourcentypen und Ereignisse es gibt und welche Felder jeweils mitkommen, listet der Ereigniskatalog in der API-Dokumentation.
Braucht dein Empfänger ein eigenes Format, schalte Nutzlaststruktur überschreiben ein und lege unter Eigene Nutzlaststruktur (Mapping) fest, welche Felder unter welchem Namen gesendet werden. Dann entfällt der oben gezeigte Rahmen, und es kommt nur deine Struktur an.
Timeout einstellen
festiware wartet nach jedem Aufruf auf die Antwort des Empfängers. Kommt sie nicht rechtzeitig, gilt der Versuch als gescheitert und wird wiederholt. Standardmäßig wartet festiware 15 Sekunden.
Manche Empfänger brauchen länger, etwa ein Google Apps Script, das erst eine Tabelle öffnet. Dann trägst du im Webhook unter Timeout (Sekunden) einen höheren Wert ein, höchstens 60. Lässt du das Feld leer, gelten 15 Sekunden.
Bricht festiware vor dem Ende ab, arbeitet der Empfänger trotzdem weiter, und die Wiederholung kommt ein zweites Mal an. Ist dir das schon passiert, erhöhe das Timeout. Am sichersten ist ein Empfänger, der doppelte Aufrufe erkennt: Die Kopfzeile
webhook-idbleibt bei den automatischen Wiederholungen desselben Aufrufs gleich.
So hat auch ein langsamer Empfänger genug Zeit, und jede Änderung kommt einmal an.
Ausführungen prüfen und erneut senden
Jeder Aufruf erscheint in der Detailansicht des Webhooks unter Ausführungen. Dort siehst du den Status, die Zahl der Versuche, bei Fehlern Fehlertyp und Fehlermeldung sowie unter Antwort, was der Empfänger zurückgeschickt hat.
- Scheitert ein Aufruf, versucht festiware es noch zweimal, nach etwa 10 Sekunden und nach etwa 100 Sekunden. Als gescheitert gelten Antworten außerhalb von 200–299, Verbindungsfehler und Timeouts.
- Bleibt ein Aufruf fehlgeschlagen, markierst du ihn und wählst die Aktion Webhook erneut senden. festiware sendet dann den aktuellen Stand des Datensatzes, nicht den von damals.
Ein erneut gesendeter Aufruf ist ein neuer Aufruf: Er kommt mit dem Ereignis <typ>.retry an, zum Beispiel person.retry, auch wenn er ursprünglich von einem Workflow-Schritt kam. Er hat eine neue webhook-id, und triggered_by.retry_of nennt die webhook-id des ursprünglichen Aufrufs. Hat dein Empfänger das Original schon verarbeitet, erkennt er die Wiederholung daran.

So siehst du jederzeit, was angekommen ist, und holst Verpasstes nach.
Wenn viele Änderungen auf einmal passieren
Ändert sich vieles gleichzeitig, zum Beispiel bei einem Import, sendet festiware nur eine bestimmte Zahl an Aufrufen pro Minute. Wie viele, hängt von deinem Paket ab, üblich sind 60. Weicht dein Paket davon ab, steht der Wert im Dashboard unter Dein Paket. Weitere Aufrufe gehen nicht verloren, sondern kommen etwas später an; in den Ausführungen steht bei ihnen unter Fehlertyp deferred. Erst wenn sich mehr als 15 Minuten Rückstand aufstauen würden (ohne Limit im Paket: 2 Stunden), sendet festiware einen Aufruf nicht und zeigt ihn mit dem Status Abgewiesen (Ratenlimit).
Schreibt dein Empfänger Daten zurück nach festiware, kann eine Schleife entstehen: Die Änderung löst den Webhook erneut aus, der Empfänger schreibt wieder zurück. festiware erkennt das und pausiert den Webhook für diesen einen Datensatz für 10 Minuten. Alle anderen Datensätze laufen normal weiter. Solche Aufrufe erscheinen in den Ausführungen mit dem Status Abgewiesen (Ratenlimit) und lassen sich später erneut senden.
Damit bleiben sowohl festiware als auch dein Empfänger auch bei großen Änderungen stabil.