Zapier

REST-Hooks für Zapier/n8n: bei Liza-Ereignissen an eine Ziel-URL posten (Triggers) und Nachrichten senden (Actions). Basis-Pfad: /v1/zapier · Auth: Bearer

Methode	Pfad	Zweck
GET	/v1/zapier/events	Verfügbare Trigger-Events auflisten
POST	/v1/zapier/hooks	REST-Hook abonnieren (event, target_url, filters)
GET	/v1/zapier/hooks	Eigene Hook-Abos auflisten
DELETE	/v1/zapier/hooks/{id}	Hook abbestellen
GET	/v1/zapier/triggers/{event}/sample	Beispiel-/Testdaten für einen Trigger
POST	/v1/messages	Chat-Nachricht senden (Action) — siehe Messages

Trigger-Events

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

Maßgeblich ist immer GET /v1/zapier/events; ein unbekannter Name wird beim Abonnieren mit 400 unknown_event abgelehnt.

Trigger abonnieren

curl -X POST https://api.eu.liza.app/api/v1/zapier/hooks \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"event":"list_item.created","target_url":"https://hooks.zapier.com/…"}'

Bei jedem passenden Ereignis sendet Liza ein POST an target_url. Der Body ist – wie Zapier es für REST-Hooks erwartet – ein Array mit einem Record:

[ { "id": "…", "sid": "…", "text": "Release vorbereiten", "list": "…" } ]

Zum Beenden den Hook per DELETE /v1/zapier/hooks/{id} entfernen.

Zustellung & Aufräumen

• Zustellung ist fire-and-forget pro Hook, Timeout 10 Sekunden. Es gibt keine Wiederholung bei Fehlern.
• Antwortet ein Hook mit 410 Gone (Zapier meldet das für deaktivierte oder gelöschte Zaps), entfernt Liza die Subscription automatisch.
• Zum Testen liefert GET /v1/zapier/triggers/{event}/sample echte Beispieldaten aus deiner Organisation.

n8n

n8n nutzt dieselbe Mechanik (generische Outbound-Hooks + Inbound-Actions).