retries, auto-disable, and the poll you still need
Delivery and reconciliation
How a delivery is attempted
- HTTPS only. The hostname must resolve to a public address, checked at send time. No redirects are followed. The timeout is 10 seconds.
- A
2xxis delivered. Anything else is retried at +1 min, +5 min, +30 min, +2 h and +8 h. - After three days of continuous failure the subscription is set
active: false, and awebhook.disabledevent goes to your other subscriptions. - If you have no other subscription,
GET /v1/mereportswebhooks.disabled. With no subscription left to notify, it is the only channel, so check it.
The last 100 deliveries per subscription are kept for 30 days. Read them with GET /v1/webhooks/{id}/deliveries, and replay one with POST /v1/webhooks/{id}/deliveries/{deliveryId}/redeliver.
Inbound is best-effort
Inbound is best-effort and at-most-once. The change feed this API listens to makes one attempt per event and never retries, and its queue is not crash-safe. A dropped event is not detectable from either side.
Read that again before you design around it. It means webhooks are a latency optimisation, not a source of truth.
Reconcile on a timer
Keep a high-water mark and sweep with updated_since.
curl -s "https://api.inittasks.com/v1/todos?updated_since=2026-09-15T17:00:00Z" \
-H "Authorization: Bearer $INITTASKS_TOKEN"Poll every few minutes and treat webhooks as the thing that usually makes the poll find nothing. Any integration that assumes every event arrives will be quietly wrong sooner or later, and quietly is the hard part.
Advance the mark only after the sweep has been processed. Advancing it first loses everything in the window if your handler dies.
See pagination and filtering for walking the pages a sweep returns.
Handling duplicates
A retry can deliver an event you already processed. Key on the event id from X-InitTasks-Event-Id and skip one you have seen.
Your reconciliation sweep will also re-deliver work the webhook already did. Make the handler idempotent and both problems go away at once.
Next
- Rate limits for how often to sweep.
- Reference for /webhooks