Tonedocs
API referenceWebhooks

Webhook endpoints

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

Open in ClaudeOpen in ChatGPTView as Markdown

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

GET
/v1/integrations/webhooks

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

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/integrations/webhooks"
{  "data": [    {      "consecutiveFailures": 0,      "createdAt": "2026-08-25T09:14:22Z",      "description": "Production — order service",      "disabledReason": null,      "enabled": true,      "events": [        "call.completed",        "campaign.finished"      ],      "id": "9f1c2d84-4e3a-4f6c-b902-7d1e8a33c451",      "url": "https://hooks.acme.example/tone"    }  ]}
Was this page helpful?

This endpoint's signing secret

Each endpoint has its own, so rotating one does not disturb the others. A live key or the dashboard only: a test key gets 403, because an endpoint receives live events too.

Remove a webhook endpoint

Deliveries stop immediately. The delivery history goes with it — disable it instead if you still need the record. A live key or the dashboard only: a test key gets 403, because an endpoint receives live events too.