Skip to main content

Webhooks (Coming Soon)

Webhooks (Coming Soon)​

This section is a forward-looking contract for webhook implementation while full endpoint docs are finalized.

Planned event model​

  • Event envelope with event_id, event_type, occurred_at, and payload.
  • Delivery attempts tracked with attempt count and terminal status.
  • Idempotent consumer expectations for at-least-once delivery.

Planned retry behavior​

  • Immediate attempt on event emission.
  • Exponential retry on >= 500 or timeout.
  • Dead-letter handling after max attempts.

Planned signature verification​

  • Signature header over raw request body.
  • Shared secret per endpoint subscription.
  • Replay protection via timestamp tolerance and event ID caching.
info

Implement your receiver using raw-body signature validation now; final event taxonomy will be added with endpoint docs.