Webhook Delivery Service  ·  View 11 of 20  ·  Runtime

Critical Flow — Event to First Attempt

Seventeen messages, and the one that ends the product's involvement.

Editable source SVG draw.io All views
Product Service Intake API Event & Attempt Store Fan-out Service Endpoint Queue Delivery Worker Customer Endpoint 1. POST /v1/events 2. size cap, event id 3. persist payload 4. durable 5. 202 + event_id (≤ 15 ms p99) 6. event committed 7. match type + entitlement 8. mint idempotency key 9. one message per endpoint 10. lease, group = endpoint 11. health + circuit check 12. resolve + address check 13. sign timestamp + body 14. POST, signed 15. 200 OK 16. delete message 17. record attempt Critical Flow — Event Committed to First Attempt The product's write path ends at message 5. Everything after it happens on the platform's schedule. v 1.0 · owner Integration Platform Architecture · date 2026-09

Where the boundary falls

  • Message 5 is the whole architecture: the product is acknowledged as soon as the event is durable, and nothing after it can make a product transaction slower or less available (ADR-01).
  • Messages 11 to 13 run on every single attempt and are all node-local — health check, address re-resolution, signing. None of them is a call to a shared service, because at 45,000 attempts/s a per-attempt round trip is the bottleneck and the outage.
  • Message 16 deletes the queue message only after a successful outcome. A worker that dies mid-attempt results in redelivery on the visibility timeout, not a lost event.

Budgets, all assumptions

  • Intake acknowledgement ≤ 15 ms p99, independent of subscription count.
  • First attempt dispatched within 250 ms p50 and 2 s p99 of acceptance, for healthy endpoints.
  • Per-attempt timeouts 5 s connect, 10 s to first byte, 15 s total — long enough for a synchronous consumer handler, short enough that a stalled endpoint does not hold a worker.

What this view cannot show

  • The failure branches. Every non-2xx path is view 12, deliberately, so this page stays readable as the happy path.
  • Fan-out to N endpoints is one message here. The real fan-out is 1.8 deliveries per event at the mean and 40 at p99.