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

# List Webhooks

> List all webhooks in your organization.

Retrieve a paginated list of webhooks registered for your organization.

## Endpoint

```
GET /v1/accounts/:accountId/webhooks
```

## Authentication

**Bearer token** required.

## Query Parameters

<ParamField query="limit" type="number" default="50">
  Number of webhooks to return. Maximum `100`.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of webhooks to skip.
</ParamField>

<ParamField query="search" type="string">
  Case-insensitive partial match on the webhook URL.
</ParamField>

## Response

<ResponseField name="webhooks" type="WebhookRegistrationPublic[]">
  Array of webhook objects. The `secret` field is **not** included. See [`WebhookRegistrationPublic`](/types/webhooks#webhookregistrationpublic).
</ResponseField>

<ResponseField name="total" type="number">
  Total number of webhooks.
</ResponseField>

<ResponseField name="limit" type="number">
  The limit used.
</ResponseField>

<ResponseField name="offset" type="number">
  The offset used.
</ResponseField>

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.collab-kit.com/v1/accounts/${ACCOUNT_ID}/webhooks?limit=10" \
    -H "Authorization: Bearer ${TOKEN}"
  ```

  ```typescript JavaScript theme={null}
  const res = await fetch(`https://api.collab-kit.com/v1/accounts/${accountId}/webhooks?limit=10`, {
    headers: { 'Authorization': `Bearer ${token}` },
  });
  const { data } = await res.json();
  ```
</CodeGroup>

```json Response theme={null}
{
  "type": "response",
  "success": true,
  "description": "Webhooks retrieved",
  "data": {
    "webhooks": [
      {
        "id": "wh_abc123",
        "organization_id": "a1b2c3d4-...",
        "url": "https://api.example.com/collab-webhook",
        "events": ["participant.joined", "participant.left"],
        "room_id": null,
        "enabled": true,
        "created_at": "2026-05-29T10:00:00.000Z",
        "updated_at": "2026-05-29T10:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0
  },
  "error": null
}
```

<Note>
  The `secret` field is never included in list or get responses. It is only returned when [creating a webhook](/api-reference/webhooks/create-webhook).
</Note>