Skip to documentation

API · Webhooks

Delete Webhook

Delete a webhook and stop further deliveries (requires full access). Delivery history is removed after deletion.

DELETE/webhooks/{webhook_id}Full access

Request parameters

ParameterTypeDescription
webhook_id
path · required
stringThe Webhook ID.

Request example

Set OPENSEND_BASE_URL=https://api.example.com and OPENSEND_API_KEY=os_replace_me on your server.

bash
curl -X DELETE "$OPENSEND_BASE_URL/webhooks/YOUR_webhook_id" \
  -H "Authorization: Bearer $OPENSEND_API_KEY"

Response

200 · application/json. Example IDs stand for IDs returned by your installation.

json
{
  "object": "webhook",
  "id": "479e3145-dd38-476b-932c-529ceb705947",
  "deleted": true
}

Behavior and errors

Deletion stops delivery immediately. Delivery and attempt records are removed in background batches.

Use a full-access credential. Unknown or foreign resources return 404. See authentication, errors, rate limits, and pagination.