Last updated

Subscriptions & events

Subscription status values

StatusMeaning
activeReceiving and delivering events normally
pausedTemporarily stopped. Events that arrive while paused are not queued — no catch-up on resume
disabledSet by the circuit breaker after 50 consecutive failures. Re-enable via PATCH

Subscription limits

  • Maximum 10 active subscriptions per company
  • url must be HTTPS — HTTP is rejected
  • url cannot target private, loopback, or link-local addresses
  • Maximum payload size: 65 KB

Event status values

StatusMeaning
receivedEvent ingested; delivery not yet started
deliveringAt least one delivery is pending, queued, or awaiting retry
deliveredAll subscriptions received the event successfully
partially_deliveredAt least one subscription succeeded; at least one failed or exhausted retries
failedAll subscriptions failed or exhausted retries

Delivery status values

StatusMeaning
pendingAwaiting first delivery attempt
queuedPicked up and about to be delivered
successDelivered successfully (HTTP 2xx received)
failedDelivery failed (non-2xx, timeout, or network error)
pending_retryFailed but scheduled for automatic retry
exhaustedAll retry attempts used without success