Hooksbase

Glossary · Product

Delivery

A single dispatch lifecycle to a destination — includes all retry attempts.

Product

What is a delivery?

A delivery is a single dispatch lifecycle to one destination — from initial dispatch through all retry attempts to final outcome (success, terminal failure, or DLQ).

A delivery has one source event but can have many attempts. Each attempt is one HTTP request; the delivery encompasses all of them.

Delivery lifecycle states

Every delivery moves through these states:

  • Queued — created and waiting for the next available worker
  • Scheduled — deferred via x-hooksbase-deliver-at header to a future time
  • In progress — currently being dispatched (an attempt is in progress)
  • Retrying — waiting for the next retry attempt
  • Succeeded — an attempt returned 2xx
  • Failed — all retries exhausted; a DLQ entry is recorded for recovery
  • Canceled — delivery processing was stopped before completion

A delivery is the unit of correlation. When a customer asks "did you deliver this event?", the answer is a single delivery's status — even though that delivery may have included a dozen attempts.

One event, one selected delivery path

A single ingested event creates a delivery for the destination selected by routing. Rules are evaluated in priority order; the first match wins, and unmatched events go to the default destination.

If you need true multi-consumer fan-out, use a downstream broker destination such as EventBridge, SQS/SNS, or your own HTTP fan-out service, and let Hooksbase track delivery into that handoff point.

Why this granularity matters

Delivery is the right unit for billing, observability, and replay: you replay a specific delivery record, not a vague "event." Hooksbase pricing, quotas, and reporting all key off delivery counts.

For the broader pattern: Routing, transforms, and replay for AI agents.

Frequently asked questions

What is the difference between a delivery and an attempt?

A delivery is the whole dispatch lifecycle to one destination; an attempt is a single HTTP request within it. Eight failed attempts followed by a successful one is one successful delivery, not nine events.

What states does a delivery move through?

Queued, scheduled if it was deferred to a future time, in progress, retrying, and then one of succeeded, failed with a DLQ entry recorded for recovery, or canceled.

What is Hooksbase?

Hooksbase is event infrastructure for AI agents. It ingests events over four channels — HTTP, email, HTML form, and scheduled cron — verifies them, routes them by rule, runs versioned Automations in the event path, and delivers them to HTTP and cloud destinations (AWS SQS, AWS EventBridge, GCP Pub/Sub, and S3-compatible storage) with retries, strict ordering, Standard Webhooks-compatible signing, deterministic replay, and a dead-letter path. It is a hosted service, runs on Cloudflare Workers, is operated at hooksbase.com, and is not affiliated with — and shares no code or ownership with — other similarly named webhook, hook, or tunnelling tools.

Related terms

Back to glossary