# Wenn keine Zustellung ankommt

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.

> **Typ:** fehlerhilfe
> **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.

| 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](/de/webhooks/event-types-organization) und [Inhalte, Programme, Geräte, Apps](/de/webhooks/event-types-content-devices); 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](/de/webhooks/delivery-and-retries#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](/de/webhooks/delivery-and-retries#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](/de/webhooks/about-delivery#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](/de/webhooks/verify-signature) |
| 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](/de/webhooks/verify-signature#schritte) |
| 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](/de/webhooks/create-endpoint#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](/de/webhooks/create-endpoint) |
| 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](/de/webhooks/delivery-and-retries#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](/de/webhooks/delivery-and-retries#das-zustell-log-ü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.