RinghouseAPI reference
Get started

Webhooks

Delete a webhook

Unsubscribe. Anything already queued for it is dropped with it.

DEL/v1/webhooks/{webhook_id}

Needs the webhooks:write scope.

Path parameters

webhook_idstringrequired
Webhook id

Returns

The subscription that stopped. A failed call answers with an error instead.

idstring
createdAtstring
disabledAtstringnullable
Null while the endpoint is live; set when we stopped trying, with `disabledReason` saying why.
disabledReasonstringnullable
eventsstring[]
namestringnullable
What the workspace calls it; null when nobody named it.
numberIdsstring[]nullable
The numbers whose calls and messages it hears; null means every number.
urlstring
curl -X DELETE https://api.ringhouse.ai/v1/webhooks/{webhook_id} \
  -H "Authorization: Bearer rh_live_xxxxxxxx"
{
  "id": "8c1d4e7a-5b2f-4a90-9e1c-3f7d2b6a1c08",
  "createdAt": "2026-09-25T14:02:11Z",
  "disabledAt": null,
  "disabledReason": null,
  "events": [
    "call.missed"
  ],
  "name": "Missed calls → Slack",
  "numberIds": null,
  "url": "https://hooks.example.com/ringhouse"
}