List Webhooks

Retrieve a paginated list of webhooks registered for your organization.

Endpoint

GET /v1/accounts/:accountId/webhooks

Authentication

Bearer token required.

Query Parameters

number

default:"50"

Number of webhooks to return. Maximum 100.

number

default:"0"

Number of webhooks to skip.

string

Case-insensitive partial match on the webhook URL.

Response

WebhookRegistrationPublic[]

Array of webhook objects. The secret field is not included. See WebhookRegistrationPublic.

number

Total number of webhooks.

number

The limit used.

number

The offset used.

Example

curl "https://api.collab-kit.com/v1/accounts/${ACCOUNT_ID}/webhooks?limit=10" \
  -H "Authorization: Bearer ${TOKEN}"

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

Response

{
  "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
}

The secret field is never included in list or get responses. It is only returned when creating a webhook.

Overview

Rooms

Users

Storage

Webhooks

Workflows

Endpoint

Authentication

Query Parameters

Response

Example

​Endpoint

​Authentication

​Query Parameters

​Response

​Example

Endpoint

Authentication

Query Parameters

Response

Example