> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Webhooks

> Retrieve every webhook subscription on your workspace, including URL, subscribed events, and active status.

<Warning>
  **Legacy endpoint - deprecated.** Unversioned endpoints are scheduled for removal on **July 31, 2026**. Use the [`/v1` version](/docs/api-reference/v1/webhooks/list) for new integrations. This endpoint remains available for existing integrations until then.
</Warning>

Returns every webhook subscription registered on your workspace, paginated. Each entry includes the webhook's `id`, delivery `url`, the list of subscribed `events`, the active/inactive flag, and the creation timestamp. Signing `secret` values are never returned, they are shown only once when the webhook is created. Use this endpoint to audit which destinations DialNexa is currently delivering events to, identify endpoints that should be retired, or confirm a webhook exists before triggering a test event.

## 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](/docs/api-access/webhook-retries-and-failures) to surface unhealthy subscriptions.

## Query parameters

| Parameter   | Description                                 |
| ----------- | ------------------------------------------- |
| `page`      | Page number, starting from 1.               |
| `limit`     | Results per page (max 100, default 20).     |
| `is_active` | Filter by active or inactive subscriptions. |

## Errors

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

## Related endpoints

* [Get Webhook](/docs/api-reference/v1/webhooks/get): fetch a single webhook's detail.
* [Create Webhook](/docs/api-reference/v1/webhooks/create): register a new subscription.
* [Update Webhook](/docs/api-reference/v1/webhooks/update): change URL, events, or active flag.
* [Delete Webhook](/docs/api-reference/v1/webhooks/delete): permanently remove a subscription.
* [Pagination](/docs/api-reference/pagination): how DialNexa list endpoints paginate.


## OpenAPI

````yaml GET /user-webhooks
openapi: 3.0.0
info:
  title: DialNexa API
  description: >-
    Public REST API for the DialNexa voice AI platform. Versioned endpoints are
    under /v1; unversioned endpoints are legacy and deprecated.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: API Keys
  - name: Agent Functions
  - name: Agents V1
  - name: Agents2
  - name: Batch Calls
  - name: Batch Calls V1
  - name: Call Logs
  - name: Calls
  - name: Calls V1
  - name: Campaign Leads
  - name: Campaigns
  - name: External Webhooks
  - name: Knowledge Base
  - name: Knowledge Base V1
  - name: LLMs
  - name: LLMs V1
  - name: Languages
  - name: Languages V1
  - name: Organization Phone Numbers
  - name: Organization Phone Numbers V1
  - name: Phone Number Pricing
  - name: Phone Number Pricing V1
  - name: Transcribers
  - name: Transcribers V1
  - name: User Webhooks
  - name: User Webhooks V1
  - name: V1
  - name: Voices
  - name: Voices V1
  - name: Webcall
  - name: Workflow Leads
  - name: Workflow Leads V1
  - name: Workflows
  - name: Workflows V1
paths:
  /user-webhooks:
    get:
      tags:
        - User Webhooks
      summary: List all user webhooks for an organization
      description: >-
        **Legacy endpoint - deprecated, scheduled for removal on July 31,
        2026.** Use the `/v1` version for new integrations. 
      operationId: UserWebhooksController_findAll
      parameters:
        - name: x-organization-id
          in: header
          description: RSA encrypted organization ID (base64 format)
          required: true
          schema:
            type: string
            example: BASE64_ENCRYPTED_ORG_ID_HERE
        - name: limit
          required: false
          in: query
          description: 'Number of records per page (default: 10)'
          schema:
            example: 10
            type: number
        - name: page
          required: false
          in: query
          description: 'Page number (default: 1)'
          schema:
            type: number
            example: 1
      responses:
        '200':
          description: ''
      deprecated: true
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````