Skip to main content

Webhook delivery and subscription events

Summary​

Two new webhook event types are available for monitoring webhook delivery and subscription changes.

New event types​

  • webhook.event.deliveryFailed — emitted when a delivery fails permanently (after retries are exhausted, or when the subscription is missing). Not emitted for failures of webhook.event.deliveryFailed itself.
  • webhook.subscription.updated — emitted when a subscription is updated, including status changes such as delivery pause (API updates and automatic circuit-breaker pause).

See the Webhook system events reference page for payload identifiers and metadata.

Payload notes​

  • identifiers contains only related record IDs (for example subscriptionId, outboxId).
  • Contextual fields live under optional top-level metadata with native types:
    • webhook.event.deliveryFailed: failedEventType (string), optional httpStatusCode (number)
    • webhook.subscription.updated: deliveryPaused (boolean)

Migration​

Subscribe to the new event type strings when creating or updating a webhook subscription. No changes are required for existing subscriptions unless you want to receive these events.

mutation CreateWebhook {
  createWebhook(
    input: {
      label: "Webhook monitoring"
      url: "https://your-app.com/webhooks/semble-meta"
      eventTypes: [webhook.event.deliveryFailed, webhook.subscription.updated]
    }
  ) {
    data {
      id
      eventTypes
    }
    error
  }
}