Skip to main content

Webhook Reliability Guide

Reliable webhook delivery means events reach their destination even when networks, services, or infrastructure experience failures.

At-Least-Once Delivery

Zen Mesh uses at-least-once delivery semantics. Events are retried automatically when delivery fails, and consumers can use idempotency handling to process duplicates safely. At-least-once does not mean exactly-once — consumers should expect possible duplicates during recovery scenarios.

Failure Recovery

When delivery fails, the system attempts retries according to the configured policy. If all retries are exhausted, the event is preserved in the dead-letter queue. From the DLQ, events can be inspected, replayed, or archived.

Learn more about Replay and Recovery

Duplicate Handling

Duplicate events can arrive from source retries, network retransmission, or recovery workflows. Deduplication identifies duplicates by comparing event keys against a time-bounded store. Idempotency provides consumer-side protection.

Learn more about Deduplication | Idempotency

Delivery Evidence

Every delivery attempt is recorded with outcome, timestamps, and cryptographic integrity proofs. Evidence is machine-readable and accessible through evidence manifests.

Learn more about Delivery Evidence