WEBHOOKS
Webhook errors
Diagnose endpoint configuration, signature, delivery and response errors.
Real-time
Event driven
As events happen
Reliable delivery
Automatic retries
Exponential backoff
Signatures
HMAC SHA-256
Verify every payload
Endpoint limit
100 endpoints
Per tenant
Payload
JSON
Versioned envelope
Configuration errors
| Error | Cause |
|---|---|
| invalid_url | Endpoint is not valid HTTPS |
| invalid_event | Unknown/unauthorized event type |
| endpoint_limit | Tenant endpoint limit reached |
Delivery errors
| Error | Cause |
|---|---|
| timeout | Endpoint did not respond in time |
| connection_failed | TLS/network connection failed |
| non_success_status | Endpoint returned non-2xx |
Signature errors
Signature failures should be diagnosed on the consumer side using raw-body verification and timestamp handling.
HTTP responses
| HTTP | Meaning |
|---|---|
| 400 | Invalid webhook configuration |
| 401/403 | Authentication/permission issue |
| 404 | Endpoint not found |
| 409 | Configuration conflict |
| 429 | Rate limit |
| 500 | Platform error |