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

# List Webhooks

> Fetch all webhooks configured for your workspace

This endpoint fetches all webhooks configured for your workspace.

## Response

<ResponseField name="webhooks" type="array">
  Array of webhook objects
</ResponseField>

<ResponseField name="id" type="string">
  Unique identifier for the webhook
</ResponseField>

<ResponseField name="url" type="string">
  The webhook URL where events will be sent
</ResponseField>

<ResponseField name="events" type="array">
  Array of event types this webhook is subscribed to
</ResponseField>

<ResponseField name="isEnabled" type="boolean">
  Whether the webhook is currently enabled
</ResponseField>

<ResponseField name="description" type="string" nullable>
  Optional description for the webhook
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp when the webhook was created
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp when the webhook was last updated
</ResponseField>

<RequestExample>
  ```javascript Node.js theme={null}
  const options = {
    method: 'GET',
    headers: {
      'x-api-key': '<your-api-key>',
    },
  };

  fetch('https://api-v2.getomni.ai/api/v1/webhooks', options)
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));
  ```

  ```python Python theme={null}
  import requests

  url = "https://api-v2.getomni.ai/api/v1/webhooks"
  headers = {
      "x-api-key": "<your-api-key>"
  }

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```bash cURL theme={null}
  curl --request GET \
    --url https://api-v2.getomni.ai/api/v1/webhooks \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "06e4b90b-86dd-41c7-9a1e-73a592963682",
      "workspaceId": "6048d78a-584a-4f1e-9e39-e011ca4cc48c",
      "url": "https://c4b3632a95ef.ngrok-free.app/webhook/test-receiver",
      "secret": null,
      "events": [
        "action_log.completed",
        "action_log.failed"
      ],
      "isEnabled": false,
      "description": null,
      "createdAt": "2025-10-30T19:49:46.581Z",
      "updatedAt": "2025-10-30T20:07:31.930Z"
    }
  ]
  ```
</ResponseExample>
