Skip to main content

Webhooks

Webhooks let your backend receive event notifications when key actions happen on your account.

Delivery model

  • Events are delivered with an HTTP POST request to your configured endpoint
  • Your endpoint should return 2xx quickly after validation
  • Process events asynchronously to avoid timeouts

Receiver checklist

  • Use HTTPS endpoints only
  • Verify incoming payload integrity before processing
  • Make handlers idempotent (safe to retry)
  • Log webhook event IDs for traceability

Retry safety

Always assume duplicate or delayed webhook deliveries are possible. Use event IDs to deduplicate.