Webhooks
Es gibt zwei Richtungen — nicht verwechseln:
| Richtung | Weg |
|---|---|
| Liza → deine URL (ausgehend) | REST-Hooks über /v1/zapier/hooks — siehe Zapier. Dieselbe Mechanik nutzen Zapier und n8n. |
| Dein Dienst → Liza (eingehend) | Signatur-verifizierte Empfänger unter /v1/integrations/webhook/*. Sie werden nicht von Hand angesprochen, sondern beim Verbinden einer Integration eingerichtet. |
Ausgehend: Liza → deine URL
Abonniere eines der Trigger-Events und erhalte bei jedem passenden Ereignis ein POST mit JSON:
| Event | Feuert, wenn … |
|---|---|
list_item.created | eine Aufgabe angelegt wurde |
block.created | ein Chat-Block/eine Nachricht entstanden ist |
notification.created | eine Benachrichtigung erzeugt wurde |
curl -X POST https://api.eu.liza.app/api/v1/zapier/hooks \
-H "Authorization: Bearer DEIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"event":"block.created","target_url":"https://example.com/liza-hook"}'Der Body ist ein Array mit einem Record. Antworte mit 2xx. Bei 410 Gone entfernt Liza die Subscription automatisch; andere Fehler werden nicht wiederholt.
Die aktuell gültige Event-Liste liefert GET /v1/zapier/events.
Eingehend: dein Dienst → Liza
Für native Provider (GitHub, Stripe, Sentry, AppSignal, Salesforce, Zapier, n8n, Custom Webhook) stellt Liza pro Abo eine eigene Empfangs-URL bereit und prüft die Signatur des Anbieters. Eingerichtet wird das beim Verbinden der Integration im Client — die Empfänger-Pfade sind kein Entwickler-Endpunkt.
Für Dienste ohne nativen Provider gibt es Custom Webhook: du bekommst eine URL, deren Payload als Block im Chat einer Liste oder eines Items landet.