Troubleshooting•stable•Updated 2026-07-06

Webhook failures

Diagnose and fix webhook failures.

Use this page when the symptom matches what you see in Kadryn or in your integration logs.

Symptoms

  • Webhook endpoint shows failed, retrying or quarantined deliveries.

Most common causes

  • Endpoint returns non-2xx.
  • Signature verification fails.
  • Timeouts.
  • Endpoint unavailable.

Fix

  1. Open delivery details.
  2. Verify endpoint URL is HTTPS.
  3. Validate signatures using raw body.
  4. Replay safely after fixing.

Verify the fix

  • Re-run the smallest safe test.
  • Open Logs & Traces and search by request ID, trace ID or resource ID.
  • Confirm the relevant dashboard card updates after refresh.
  • Confirm no retry loop or duplicate delivery was created.

When to escalate

Escalate when the issue affects production traffic, billing-sensitive reporting, audit evidence, or any workflow where a customer-facing AI feature is blocked.

Related pages