Skip to content

Webhooks — Delivery & Retries

Last updated September 9, 2026

A non-2xx response, a connection failure, or a timeout schedules a retry. Six attempts in total, spanning just under 15 hours, after which the delivery is abandoned.

Attempt Delay after previous Cumulative time after the event
1 Immediate 0
2 1 minute ~1 minute
3 5 minutes ~6 minutes
4 30 minutes ~36 minutes
5 2 hours ~2 hours 36 minutes
6 12 hours ~14 hours 36 minutes
— No further attempts Delivery abandoned

Every attempt is recorded with its response status, response body, and error message.

If you had an outage and missed events entirely, ask Omnishelf staff — the delivery history is queryable, and catching up on missed orders is also just:

curl -s "$BASE_URL/v1/fulfilment-orders?status=processing" \
  -H "Authorization: Bearer $OMNI_KEY"