Skip to content
API reference/Webhooks

Delete a webhook

Try it

Stops sending to the address for good; deliveries still waiting are dropped.

DELETE/api/v1/webhooks/{webhook_id}

Authentication

An API key as Authorization: Bearer or x-api-key. It needs the webhooks:manage scope — add, change and delete webhooks.

webhooks:manageDeletesIdempotency-Key optionalMCP tool: delete_webhook

Parameters

Named placeholders go in the path; the rest in the query string.

webhook_idstringPath · required
The webhook's id.1 to 100 characters

Response

200 with JSON on success (schema on the right). Errors use the standard envelope; a retry with the same Idempotency-Key gets the first answer back (how retries work).

curl
curl -X DELETE 'https://websites.workflowcorp.com/api/v1/webhooks/WEBHOOK_ID' \
  -H "Authorization: Bearer $WEBSITEBUDDY_API_KEY"
Example arguments
{
  "webhook_id": "WEBHOOK_ID"
}
Response schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "deleted": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "id",
    "deleted"
  ],
  "additionalProperties": false
}