Skip to main content

Idempotency

Use the event id and resource resourceId for idempotent processing:

Error Handling

Always return appropriate HTTP status codes:

Retry Handling

Our webhook system will retry failed deliveries. Handle retries gracefully:
  • Return 2xx status codes for successful processing
  • Return 4xx status codes for permanent failures (we won’t retry)
  • Return 5xx status codes for temporary failures (we will retry)

Security

Always verify webhook authenticity:

Resource Routing

Use resourceType and resourceId for efficient routing: