Skip to main content
GET
List Webhooks
Read only
Recommended. This endpoint is part of the public /v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.
Returns every webhook subscription registered on your workspace, paginated. Each entry includes the webhook’s id, delivery url, subscribed events, active flag, creation timestamp, and a masked secret value. The original signing secret is never returned after creation. Use this endpoint to audit destinations, identify subscriptions to retire, or confirm configuration before a test.

When to use this

  • Webhook audits: render a table of every webhook with its destination, subscribed events, and active status.
  • Decommissioning checks: find webhooks pointing at retired URLs before they accumulate failed deliveries.
  • Migration tooling: enumerate webhooks before re-registering them under a new event taxonomy.
  • Operational dashboards: combine with Webhook retries and failures to surface unhealthy subscriptions.

Query parameters

Errors

  • 403 Forbidden is returned when the API key cannot read webhook configuration on this workspace.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
number

Results per page (default: 10)

Example:

10

page
number

Page number (default: 1)

Example:

1

Response

Webhooks returned successfully.

message
string
Example:

"Webhooks fetched successfully"

webhooks
object[]
page
number
Example:

1

limit
number
Example:

10

total
number
Example:

5

totalPages
number
Example:

1