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

# List Webhooks

> List all webhook subscriptions registered in your Essal workspace.

## List Webhooks

`GET /v1/webhooks`

Returns all webhook subscriptions for the workspace.

**Response**

```json theme={null}
{
  "data": [
    {
      "id": "wh_01HXYZWH1",
      "url": "https://hooks.example.com/essal",
      "events": ["sales.deal.won", "guard.alert.triggered"],
      "status": "active",
      "created_at": "2026-07-01T09:00:00Z"
    }
  ],
  "meta": { "total": 3, "has_more": false }
}
```

**Query Parameters**

| Parameter | Type | Description                    |
| --------- | ---- | ------------------------------ |
| `status`  | enum | Filter by `active` or `paused` |