Skip to main content
Update a webhook’s URL, events, room scope, or enabled state. At least one field must be provided.

​
Endpoint

PATCH /v1/accounts/:accountId/webhooks/:id

​
Authentication

Bearer token required.

​
Path Parameters

​
id
string
required
The webhook’s unique ID.

​
Request Body

All fields are optional, but at least one must be provided.
​
url
string
New delivery URL.
​
events
string[]
New list of subscribed events.
​
roomId
string | null
New room scope. Set to null to subscribe to events from all rooms.
​
enabled
boolean
Enable or disable the webhook.

​
Response

​
webhook
WebhookRegistrationPublic
The updated webhook object (without the secret field). See WebhookRegistrationPublic.

​
Example

curl -X PATCH https://api.collab-kit.com/v1/accounts/${ACCOUNT_ID}/webhooks/wh_abc123 \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "events": ["participant.joined", "participant.left", "user.created"],
    "enabled": true
  }'
Response
{
  "type": "response",
  "success": true,
  "description": "Webhook updated",
  "data": {
    "webhook": {
      "id": "wh_abc123",
      "organization_id": "a1b2c3d4-...",
      "url": "https://api.example.com/collab-webhook",
      "events": ["participant.joined", "participant.left", "user.created"],
      "room_id": null,
      "enabled": true,
      "created_at": "2026-05-29T10:00:00.000Z",
      "updated_at": "2026-05-29T11:00:00.000Z"
    }
  },
  "error": null
}