Guides

Webhook Behavior

Bridge webhooks are real-time notifications, but delivery is at-least-once and unordered.

  1. Verify webhook signatures and parse the eventId.
  2. Use Get Event to fetch the full payload.
  3. Fetch the current resource (Service, Policy, etc.) for critical decisions.

previous and data Snapshots

Some events include previous and data, but they can be stale or out of order and are being considered for deprecation. Treat them as convenience only.

Idempotency

  • Store eventId to ignore duplicates.
  • Prefer the latest resource state if updates conflict.