curl -X PATCH "https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Renamed"
}'
const response = await fetch('https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "Renamed"
})
});
import requests
response = requests.patch(
'https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
"name": "Renamed"
}
)
{
"id": "e1f2…", "name": "Renamed", "url": "https://crm.example.com/telzino", "enabled": true,
"scope": { "type": "reseller", "id": "b2c3…", "name": "West Coast" },
"include_descendants": true, "event_types": ["webhook.disabled"], "event_settings": {}, "payload_format": "nested", "api_version": "1",
"auth": { "mode": "hmac", "header_name": "X-Telzino-Secret" },
"exclude_test_accounts": false, "notify_email": null,
"health": { "state": "healthy", "failing_since": null, "last_success_at": null, "disabled_at": null, "disabled_reason": null, "held_deliveries": 0 },
"secret_rotation": { "previous_secret_expires_at": null, "next_secret_active_at": null },
"created_at": "2026-10-13T09:00:00Z", "updated_at": "2026-10-13T09:00:00Z", "created_by": "api_key:abc123" }
{ "error": "invalid_request", "error_description": "Invalid request body",
"details": [ { "code": "invalid_type", "expected": "string", "received": "number", "path": ["name"], "message": "Expected string, received number" } ] }
{ "error": "not_found", "error_description": "Webhook endpoint not found." }
Event Webhooks
Update Event Webhook
Changes the given fields of an endpoint
PATCH
/
v1
/
webhooks
/
{webhookId}
curl -X PATCH "https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Renamed"
}'
const response = await fetch('https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "Renamed"
})
});
import requests
response = requests.patch(
'https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
"name": "Renamed"
}
)
{
"id": "e1f2…", "name": "Renamed", "url": "https://crm.example.com/telzino", "enabled": true,
"scope": { "type": "reseller", "id": "b2c3…", "name": "West Coast" },
"include_descendants": true, "event_types": ["webhook.disabled"], "event_settings": {}, "payload_format": "nested", "api_version": "1",
"auth": { "mode": "hmac", "header_name": "X-Telzino-Secret" },
"exclude_test_accounts": false, "notify_email": null,
"health": { "state": "healthy", "failing_since": null, "last_success_at": null, "disabled_at": null, "disabled_reason": null, "held_deliveries": 0 },
"secret_rotation": { "previous_secret_expires_at": null, "next_secret_active_at": null },
"created_at": "2026-10-13T09:00:00Z", "updated_at": "2026-10-13T09:00:00Z", "created_by": "api_key:abc123" }
{ "error": "invalid_request", "error_description": "Invalid request body",
"details": [ { "code": "invalid_type", "expected": "string", "received": "number", "path": ["name"], "message": "Expected string, received number" } ] }
{ "error": "not_found", "error_description": "Webhook endpoint not found." }
Path Parameters
Request Body
Send only the fields to change. The scope cannot change, and unknown fields are rejected. Rotate the secret with Rotate Secret.Settings for monitoring events, keyed by event type. Replaces the whole object; it must still cover every subscribed event that has settings. Leave it out to keep the stored settings.
A header name may use only letters, digits and hyphens (64 characters at most), and cannot be a reserved name:
Host, Content-Length, Content-Type, Transfer-Encoding, Connection, User-Agent (any case), or any X-Telzino-* name other than X-Telzino-Secret. A reserved name returns 400 invalid_request with "<name> is a reserved header name; choose another one.".An endpoint or delivery outside your API key’s scope returns
404, the same as one that does not exist.curl -X PATCH "https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Renamed"
}'
const response = await fetch('https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "Renamed"
})
});
import requests
response = requests.patch(
'https://api.telzino.com/v1/webhooks/3f2b8c1e-5d4a-4e7b-9c2d-1a6f0e8b7d54',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
json={
"name": "Renamed"
}
)
{
"id": "e1f2…", "name": "Renamed", "url": "https://crm.example.com/telzino", "enabled": true,
"scope": { "type": "reseller", "id": "b2c3…", "name": "West Coast" },
"include_descendants": true, "event_types": ["webhook.disabled"], "event_settings": {}, "payload_format": "nested", "api_version": "1",
"auth": { "mode": "hmac", "header_name": "X-Telzino-Secret" },
"exclude_test_accounts": false, "notify_email": null,
"health": { "state": "healthy", "failing_since": null, "last_success_at": null, "disabled_at": null, "disabled_reason": null, "held_deliveries": 0 },
"secret_rotation": { "previous_secret_expires_at": null, "next_secret_active_at": null },
"created_at": "2026-10-13T09:00:00Z", "updated_at": "2026-10-13T09:00:00Z", "created_by": "api_key:abc123" }
{ "error": "invalid_request", "error_description": "Invalid request body",
"details": [ { "code": "invalid_type", "expected": "string", "received": "number", "path": ["name"], "message": "Expected string, received number" } ] }
{ "error": "not_found", "error_description": "Webhook endpoint not found." }