WebhookDeliveryStatus (Enum)
WebhookDeliveryStatus tracks the lifecycle of a single delivery. State transitions: PENDING -> SENDING -> SUCCESS PENDING -> SENDING -> RETRYING -> SENDING -> ... -> SUCCESS | FAILED | EXPIRED Terminal states: SUCCESS, FAILED, EXPIRED.
Values
| Name | Number | Description |
|---|---|---|
DELIVERY_UNSPECIFIED | 0 | Default zero value. Never set by the system; indicates an uninitialized field. |
DELIVERY_PENDING | 1 | Delivery is queued but has not been attempted yet. |
DELIVERY_SENDING | 2 | Delivery is currently being sent (HTTP request in flight). |
DELIVERY_SUCCESS | 3 | Delivery succeeded. The webhook endpoint returned an expected status code (default: 200, 201, 202, 204 -- configurable via expected_status_codes). |
DELIVERY_FAILED | 4 | Delivery failed permanently. All retry attempts exhausted or the error is classified as non-retryable (client_error, dns_error, tls_error). |
DELIVERY_RETRYING | 5 | Delivery failed but will be retried. Applies to retryable error categories: server_error (5xx), timeout, connection_refused, network_error. The next_retry_at field indicates when the next attempt is scheduled. |
DELIVERY_EXPIRED | 6 | Delivery TTL elapsed before it could succeed. The event's ttl_seconds determines the expiration window. No further retries will be attempted. |
Used by
DeliveryService