Skip to main content
The Delete a Webhook Endpoint call permanently removes a registered webhook from your clinic. Once deleted, ByDoctor will stop delivering events to that URL and any queued retry attempts for that endpoint are cancelled immediately. This action cannot be undone.

​
Endpoint

​
Authentication

Include your API key as a Bearer token in the Authorization header of every request.

​
Path Parameters

​
string
required
UUID of the webhook endpoint you want to delete. You can find this value in the id field returned by GET /webhooks or POST /webhooks.

​
Response Fields

A successful deletion returns HTTP 200 OK with a confirmation object.
​
string
The UUID of the webhook endpoint that was deleted.
​
boolean
Always true for a successful deletion response.
Deleting a webhook does not affect events that have already been successfully delivered to your endpoint. However, any in-flight retry attempts for previously failed deliveries are cancelled immediately upon deletion — your endpoint will not receive those retried requests.

​
Error Responses

​
Example Request

​
Example Response

​
Pausing Instead of Deleting

If you want to temporarily stop event delivery without permanently removing the endpoint and losing its configuration, you can pause the webhook instead. Send a PATCH request with active set to false:
A paused webhook retains its URL, event subscriptions, and signing secret. You can resume delivery at any time by sending the same request with "active": true. Note that PATCH /webhooks/{id} is not listed in the main navigation as a standalone page — use the snippet above when you need it.