Tone docs
API referenceWebhooks

Remove a webhook endpoint

Deliveries stop immediately. The delivery history goes with it — disable it instead if you still need the record.

Open in ClaudeOpen in ChatGPTView as Markdown

Requires the admin scope. A key with less gets 403 insufficient_scope.

DELETE
/v1/integrations/webhooks/{id}

Authorization

AuthorizationBearer <token>

Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.

In: header

Path Parameters

id*string

The webhook endpoint's id.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/integrations/webhooks/string"
{  "data": null}
Was this page helpful?

Webhook endpoints

Every endpoint you have registered, with what it subscribes to and whether it is still enabled.

Send a delivery again now

Re-sends immediately instead of waiting for the next backoff step. The event id is unchanged, so a correctly written consumer deduplicates it.