Webhooks

Change a webhook endpoint

PATCH /v1/webhooks/{webhook_id}

Scope

webhooks:write

Tier

Tier 1

Data

Account data

Idempotency

Idempotency-Key: optional

Parameters

Request body

The fields to change.

JSON: WebhookEndpointUpdateRequest

Response

200: The endpoint.

Examples

Request example

curl

curl -sS -X PATCH \
  "https://app.dialerbee.com/api/v1/webhooks/wh_0f8fad5b-d9cb-469f-a165-70867728950e" \
  -H "Authorization: Bearer $DIALERBEE_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "events": [
    "call.completed",
    "ai_call.completed"
  ]
}'

Python (SDK)

from dialerbee import DialerBee

db = DialerBee()  # reads DIALERBEE_API_KEY from the environment

result = db.webhooks.update(
    "wh_0f8fad5b-d9cb-469f-a165-70867728950e",
    events=["call.completed", "ai_call.completed"],
)

Response example

200

{
  "id": "wh_0f8fad5b-d9cb-469f-a165-70867728950e",
  "url_preview": "https://crm.example.com/dialerbee/...",
  "host": "crm.example.com",
  "description": "CRM sync",
  "events": [
    "call.completed"
  ],
  "enabled": true,
  "secret_hint": "safe",
  "created_at": "2026-09-29T09:15:00Z",
  "updated_at": "2026-09-29T09:20:00Z"
}

Error examples

403 webhooks_disabled

{
  "type": "https://docs.dialerbee.com/errors/webhooks-disabled",
  "title": "Webhooks not enabled",
  "status": 403,
  "detail": "Webhooks are not switched on for this account.",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "webhooks_disabled",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

422 webhook_url_refused

{
  "type": "https://docs.dialerbee.com/errors/webhook-url-refused",
  "title": "Webhook URL refused",
  "status": 422,
  "detail": "The webhook URL must be https://, must resolve to a public address, and must not point to a private, loopback, link-local or cloud-metadata address.",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "webhook_url_refused",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

403 insufficient_scope

{
  "type": "https://docs.dialerbee.com/errors/insufficient-scope",
  "title": "Not permitted",
  "status": 403,
  "detail": "The API client does not hold the scope this operation requires.",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "insufficient_scope",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

Errors

Objects

WebhookEndpointUpdateRequest

WebhookEndpoint