Webhook endpoints

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

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

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`

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?

Webhook endpoints

Authorization

Response Body

200application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`