API ReferenceWebhooks

List Subscriptions

List all webhook subscriptions for your organization.

Returns all configured webhook endpoints, including their URLs, subscribed event types, and current status (enabled/disabled). Use this to audit your webhook configuration or find a specific subscription.

Authentication

x-api-keystring
API Key authentication via header

Response

List of webhook subscriptions
idstring

Unique identifier for this subscription (UUID format)

urlstring
The URL where webhook events are delivered
created_atstringformat: "date-time"

When this subscription was created (ISO 8601 format, UTC)

updated_atstringformat: "date-time"

When this subscription was last updated (ISO 8601 format, UTC)

filter_typeslist of strings or null
Event types this subscription is filtered to receive. See EventType enum for all available types.
disabledboolean or nullDefaults to false
Whether this subscription is currently disabled. Disabled subscriptions do not receive event deliveries.
descriptionstring or null

Optional human-readable description of this subscription

delivery_attemptslist of objects or null

Recent delivery attempts for this subscription. Only included when fetching a single subscription via GET /subscriptions/{id}.

secretstring or null

The signing secret for webhook signature verification. Only included when include_secret=true is passed to the API. Keep this secret secure.

Errors