Webhooks
List Webhooks
List webhook endpoints for your workspace.
GET
List Webhooks
Read only
Returns every webhook subscription registered on your workspace, paginated. Each entry includes the webhook’s
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.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 Forbiddenis returned when the API key cannot read webhook configuration on this workspace.
Related endpoints
- Get Webhook Details: fetch a single webhook’s detail.
- Create Webhook: register a new subscription.
- Update Webhook: change URL, events, or active flag.
- Delete Webhook: permanently remove a subscription.
- Pagination: how DialNexa list endpoints paginate.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Results per page (default: 10)
Example:
10
Page number (default: 1)
Example:
1
List Webhooks