Skip to content

Webhooks ​

Es gibt zwei Richtungen — nicht verwechseln:

RichtungWeg
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:

EventFeuert, wenn …
list_item.createdeine Aufgabe angelegt wurde
block.createdein Chat-Block/eine Nachricht entstanden ist
notification.createdeine Benachrichtigung erzeugt wurde
bash
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.