Skip to main content
GET
List Webhooks
Read only Returns the webhook subscriptions registered on your workspace, newest first, paginated. Records are in data.webhooks, with data.page, data.limit, data.total, and data.totalPages. Each entry includes the webhook’s id, delivery url, subscribed events, is_active, created_at, updated_at, last_triggered_at, org_id (the workspace ID without the org_ prefix), is_deleted, 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: use last_triggered_at to spot subscriptions that have not received a delivery recently. It records the last attempt, not whether your endpoint accepted it.

Query parameters

Errors

  • 401 Unauthorized is returned when the API key is missing or invalid.

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, a whole number of 1 or more (default: 10). Not validated: 0 or a negative value gives an unusable response or an error.

Example:

10

page
number

Page number, a whole number of 1 or more (default: 1).

Example:

1

Response

Webhooks returned successfully.

success
enum<boolean>
required
Available options:
true
error
enum<boolean>
required
Available options:
false
statusCode
integer
required
Example:

200

message
string
required
Example:

"Success"

data
object
required
timestamp
string<date-time>
required