POST of the record, retried until it arrives or runs out of attempts.
Destinations
Add one on a project’s Connections tab with Add destination, or From preset for Slack, Datadog and email. A destination has:- a type, fixed when you create it: HTTPS webhook (the default), Slack or S3-compatible bucket. See Destination types and options;
- for a webhook, a URL, which must be
https. A Slack destination has its incoming-webhook URL and an S3 destination its bucket settings instead, with the credential stored encrypted; - a Dataset filter: the datasets it receives, or all of them when you leave it empty. An empty list is refused, since it would mean nothing rather than everything: to stop deliveries, disable the destination;
- a signing secret (
whsec_…), shown in full when you create it. Owners and admins can reveal it again at any time with Reveal secret on the destination, and rotate it; see Verify signatures; - optional request options: a body template, and for a webhook, custom headers and authentication;
- delivery settings: a timeout (10 seconds by default), a send rate and a concurrency cap.
Deliveries
A delivery is one record sent to one destination. To an HTTPS webhook it is, by default, the envelope{"id", "dataset", "received_at", "data"}, with these headers:
A Slack destination is sent a readable message, and an S3 destination writes each event as one JSON object. Neither carries these headers: Slack checks no signature, and an S3 request is signed with your own key.
Delivery is at-least-once and unordered. Each delivery has a status:
Attempts and retries
Each try is an attempt, and a delivery gets up to eight. After a failed one, Hookie waits about 5 seconds, then 5 minutes, 30 minutes, 2 hours, 5 hours, 10 hours and 10 hours, give or take 20%: about 27 hours in all. ARetry-After on a 429 or 503 is the least it waits.
Slack and S3 destinations follow the same schedule with one difference: a
404 is not retried. From Slack it means the incoming webhook was revoked, and from a bucket NoSuchBucket; neither comes back by waiting. See Slack’s answers and Retries and replays overwrite.
Every failed attempt is kept with its status code, latency, error and the start of the response; the delivery keeps the latest response body, up to 16 KiB. Details, the eye icon on a row, shows them. Waiting under a rate or concurrency limit uses no attempt.
After 10 dead deliveries in a row, over at least an hour, Hookie switches the destination off and holds its new deliveries. See When a destination keeps failing.
The delivery allowance and holds
Each plan includes deliveries a month: 10,000 on Free, 50,000 on Starter, 90,000 on Pro and 600,000 on Team, with 10% of grace on the paid plans. A delivery is counted once, when it is created: its retries are free, and a replay, being a new delivery, is counted. Past the allowance, events are still received, stored and routed, but their deliveries are held: not sent, and not lost. Once there is room, after the 1st of the month (UTC) or an upgrade, Send held deliveries on the Deliveries tab sends them oldest first, stopping at the first event the allowance cannot cover. Held deliveries are never sent on their own; the API’sPOST …/deliveries/held/release and the release_held_deliveries MCP tool send them too. A held event past your plan’s retention is dropped with its record.
Replay
A delivery that did not arrive can be sent again as a new delivery, with a newHookie-Delivery-Id and the same Hookie-Event-Id:
- Replay, on the row of a delivery that did not arrive, sends it again.
- Replay matching sends again every delivery matching the tab’s status, destination and time filters that did not arrive:
deadones, andfailedones with no attempt scheduled. It takes only the latest delivery of each event to each destination, so nothing goes twice, and asks you to confirm the count first.
POST …/deliveries/{id}/replay and POST …/deliveries/replay.
What pauses a destination
- Disabling it. Its deliveries wait as
pausedand go out when you enable it again. - Failing, as above. Re-enable, on its tile or on Home, sends what it held.
- A downgrade. When the workspace moves to a plan with fewer destinations (a downgrade, a cancellation or a trial ending), the newest over the new cap are paused and tagged Paused: over plan limit, and their deliveries wait as
paused. When the plan rises again, Hookie resumes the ones it paused, oldest first, never one you switched off yourself. See When your plan changes. - A suspended workspace. Nothing is delivered until it is reinstated.
cancelled and none of them is sent, including any that were paused while it was disabled.