At-Least-Once Delivery
Events are never silently lost — even if your endpoint is down
Webhook delivery is inherently unreliable — endpoints go down, networks fail, and services restart. The only honest delivery guarantee is at-least-once: every event will be delivered at least once, retried until acknowledged, and persisted so it cannot be lost even if the delivery infrastructure restarts.
When an event is enqueued for delivery, it is durably persisted before any delivery attempt. If delivery fails — the endpoint returned a 5xx, timed out, or was unreachable — the event remains in the queue and retries according to the configured retry schedule. It stays in the queue until it receives a 2xx acknowledgement or exhausts all retry attempts.
At-least-once delivery has an important consequence: your webhook handlers must be idempotent — processing the same event twice must produce the same outcome as processing it once. Every event includes a stable event ID that your handler can use to deduplicate retries. Apitide provides tooling to inspect event IDs and understand which deliveries are retry attempts.
0
events silently lost