Webhooks
List Webhooks
List webhook endpoints for your workspace.
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_atto spot subscriptions that have not received a delivery recently. It records the last attempt, not whether your endpoint accepted it.
Query parameters
Errors
401 Unauthorizedis returned when the API key is missing or invalid.
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.
- API 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, 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, a whole number of 1 or more (default: 1).
Example:
1