Wenn keine Zustellung ankommt

Endpunkt abgelehnt, inaktiv nach Fehlschlägen, keine Wiederholung nach 4xx, Signatur passt nicht, doppelte Zustellungen, Ereignis tritt nie ein.

3 Minuten LesezeitWebhooksStand: 25.10.2026

Auf dieser Seite

Bevor Sie loslegen

Für wen: Wer einen Endpunkt betreibt und im Zustell-Log oder beim Empfänger etwas vermisst.
Voraussetzung: Zugang zu Einstellungen › Organisation › Webhooks als Inhaber oder Manager; zum Ändern und erneuten Zustellen die Rolle Inhaber.

Die häufigsten Gründe, warum ein Webhook nicht oder doppelt ankommt oder ein Endpunkt sich nicht anlegen lässt — in der Reihenfolge, in der sie auftreten.

Symptom	Bedeutung	Lösung
Der Endpunkt ist Aktiv, das Zustell-Log bleibt leer	Das abonnierte Ereignis tritt in Ihrer Organisation nicht ein, oder das Abonnement wurde erst vor Kurzem ergänzt — ein geändertes Abonnement greift bis zu eine Stunde später. Einen falsch geschriebenen oder nicht abonnierbaren Typ nimmt das Anlegen gar nicht erst an (`422 WebhookEndpoint.EventUnknown`)	Typ wörtlich mit den Tabellen abgleichen: Organisation, Konten, Abrechnung und Inhalte, Programme, Geräte, Apps; Ereignis im Portal auslösen und das Log erneut öffnen
Der Endpunkt steht auf Inaktiv mit „letzter Fehler …“	Mehr als 20 Fehlschläge in Folge haben den Endpunkt abgeschaltet; er bekommt keine neuen Zustellungen	Ursache beim Empfänger beheben, dann Aktivieren (oder `PATCH` mit `{"active": true}`); siehe Abschaltung eines Endpunkts
Eine Zustellung ist `dead`, obwohl nur ein Versuch gezählt wurde	Ihr Server hat mit 4xx (außer 408 und 429) geantwortet; das gilt als endgültiger Fehler ohne Wiederholung	Bei vorübergehenden Problemen mit 503 oder 429 antworten, nicht mit 4xx; die betroffene Zustellung über `POST /v1/webhooks/{id}/deliveries/{deliveryId}/retry` nachholen (das Portal zeigt Erneut zustellen nur bei Fehlgeschlagen); siehe Die erwartete Antwort
Zustellungen scheitern ohne Antwortcode, `responseCode` ist `null`	Ihr Server hat nicht binnen 10 Sekunden geantwortet, oder die Verbindung kam nicht zustande	Sofort mit 2xx antworten und danach verarbeiten; Erreichbarkeit der Adresse von außen prüfen; siehe Was daraus folgt
Ihr Empfänger lehnt Zustellungen ab: Signatur passt nicht	Der Rumpf wurde vor der Prüfung neu serialisiert, oder nach Secret rotieren prüft der Empfänger noch mit dem alten Secret	Rohe Bytes prüfen, neues Secret übernehmen; siehe Die Signatur einer Zustellung prüfen
Dieselbe Zustellung kommt zweimal an	Eine Wiederholung oder ein manuelles Erneut-Zustellen trägt dieselbe `X-Delivery-Id`	Nach `X-Delivery-Id` entdoppeln; siehe Die Signatur einer Zustellung prüfen
Anlegen scheitert mit Status 422, `WebhookEndpoint.UrlInvalid`	Die Adresse ist nicht https oder zeigt auf `localhost`, ein privates Netz oder einen `.local`-Namen	Öffentliche https-Adresse eintragen; siehe Regeln für Adresse und Ereignisse
Anlegen scheitert mit Status 403, `Billing.FeatureNotEntitled`; Endpunkt anlegen ist gesperrt	Ihr Paket enthält keine Webhooks; bestehende Endpunkte laufen weiter	Paket wechseln; vorhandene Endpunkte weiter bearbeiten, abschalten, löschen; siehe Einen Webhook-Endpunkt anlegen
Aufruf über die API scheitert mit Status 403, `Permission.Denied`	Der Aufruf kam mit einem API-Schlüssel oder von einem Konto ohne die Rolle Inhaber; die Webhook-Rechte gelten nur für angemeldete Konten	Mit dem Zugriffstoken einer Anmeldung als Inhaber aufrufen; siehe Rechte
Status 404, `WebhookEndpoint.NotFound` oder `WebhookDelivery.NotFound`	Die Kennung (`whk_…` bzw. `whd_…`) gehört nicht zu Ihrer Organisation oder wurde gelöscht	Kennung aus `GET /v1/webhooks` bzw. dem Zustell-Log übernehmen

Wenn keine Zeile passt: Das Zustell-Log zeigt je Zustellung Zustand, Antwortcode und Versuchszahl; bei fehlgeschlagenen Versuchen steht die Antwort Ihres Servers gekürzt in responseBody der Liste über die API.

WebhookEndpoint.Disabled (Status 409) steht im Fehlerkatalog, tritt heute aber nicht auf: Bearbeiten, Rotation und Löschen gelingen auch am inaktiven Endpunkt, und eine Wiederholung sendet dort nichts.