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

# webhooks list

> List the active webhooks in the workspace, newest first.

List the active webhooks for the authenticated workspace, with the most recently created first. The signing secret is never returned here — it is shown only once, when you run [`clay webhooks create`](/cli/reference/webhooks-create).

See the [webhooks overview](/cli/reference/webhooks) for the delivery payload shape and signature verification.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay webhooks list [--limit <n>] [--cursor <token>]
```

Results are paginated. `--limit` sets the page size, and the response includes a top-level `cursor` when more webhooks are available; pass it back with `--cursor` to fetch the next page.

## Flags

| Flag               | Description                                                        |
| ------------------ | ------------------------------------------------------------------ |
| `--limit <n>`      | Maximum webhooks to return per page (1–200). Defaults to 50.       |
| `--cursor <token>` | Resume from a previous response's `cursor` to fetch the next page. |

## Output

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": [
    {
      "id": "wh_abc123",
      "url": "https://example.com/hooks/clay",
      "createdAt": "2026-06-16T17:50:00.000Z"
    }
  ],
  "cursor": "next_page_token"
}
```

| Field              | Type   | Description                                                                                      |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------ |
| `data[].id`        | string | Webhook id.                                                                                      |
| `data[].url`       | string | The endpoint that receives deliveries.                                                           |
| `data[].createdAt` | string | Creation timestamp.                                                                              |
| `cursor`           | string | Present when more webhooks are available. Pass it back via `--cursor`. Omitted on the last page. |

## Errors

| Code               | Exit | Notes                                            |
| ------------------ | ---- | ------------------------------------------------ |
| `validation_error` | 2    | `--limit` is not a positive integer.             |
| `auth_forbidden`   | 3    | The API key lacks permission to manage webhooks. |
| `not_found`        | 6    | Webhooks are not enabled.                        |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay webhooks list
clay webhooks list --limit 100 | jq -r '.data[].url'
clay webhooks list --limit 100 --cursor "$CURSOR"
```