Skip to main content
PreparationZone Logo
PrepZone

Webhooks and Async Callbacks

Notify external systems reliably with signed payloads, retries and delivery guarantees.

Pass checkpoint below

StreamHub partners (OBS plugins, analytics dashboards, clip bots) register webhook URLs. When a stream goes live or a clip is created, StreamHub POSTs a signed JSON payload to each registered endpoint — with retries, backoff, and dead-letter handling when partners are down.

Webhooks vs polling

AspectWebhooks (push)Polling (pull)
LatencyNear real-time deliveryBounded by poll interval
EfficiencyEvents sent only when they happenEmpty polls waste bandwidth
ComplexityRetry, signing, idempotency on senderSimple client loop
Partner downtimeMissed deliveries without retry/DLQPartner catches up on next poll
StreamHub defaultPrimary for registered integrationsFallback + public API sync
  • Latency

    Webhooks (push)Near real-time delivery
    Polling (pull)Bounded by poll interval
  • Efficiency

    Webhooks (push)Events sent only when they happen
    Polling (pull)Empty polls waste bandwidth
  • Complexity

    Webhooks (push)Retry, signing, idempotency on sender
    Polling (pull)Simple client loop
  • Partner downtime

    Webhooks (push)Missed deliveries without retry/DLQ
    Polling (pull)Partner catches up on next poll
  • StreamHub default

    Webhooks (push)Primary for registered integrations
    Polling (pull)Fallback + public API sync

Webhook delivery architecture

Webhook delivery architecture

POSTfailINTEGRATION
MSK topicdomain event
COMPUTE
Webhook dispatc…EKS
EXTERNAL
Partner HTTPSHMAC signed
INTEGRATION
SQS DLQfailed deliveries
MSK event → dispatcher → HTTPS callback with SQS DLQ on failure.

Delivery pipeline

  • Event trigger: Internal event (stream.started) enters webhook dispatch queue.
  • Subscription lookup: Find all registered endpoints for this event type + streamer.
  • Delivery worker: HTTP POST with signed payload, timeout, and retry policy.
  • Delivery log: Record attempt, status code, latency for partner debugging.
  • DLQ: After max retries, park failed deliveries for manual replay.

The rest of this guide is part of Pro

Free covers every fresher guide in full. Pro unlocks Senior, Staff and Architect guides across every track.

Still to come · 3 sections

  • Payload and security
  • Retry strategy
  • Partner best practices

Test yourself

Answer these before moving on — recall is what makes it stick.