> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Event Webhook

> Changes the given fields of an endpoint

## Path Parameters

**webhookId** `string` *required*

The event webhook endpoint ID

## Request Body

Send only the fields to change. The scope cannot change, and unknown fields are rejected. Rotate the secret with [Rotate Secret](https://docs.telzino.com/api-reference/event-webhooks/rotate-secret.md).

**name** `string`

Up to 100 characters.

**url** `string`

`https` URL on a public host.

**event\_types** `string[]`

Events available at the endpoint's level.

**event\_settings** `object`

Settings for [monitoring events](https://docs.telzino.com/event-webhooks/events.md#event-settings), 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.

**include\_descendants** `boolean`

Also receive events from the levels below.

**payload\_format** `string`

`nested` or `flat`.

**auth** `object`

`{ "mode"?: "hmac" | "shared_secret", "header_name"?: string }`.

**exclude\_test\_accounts** `boolean`

Skip events from Telzino test accounts.

**notify\_email** `string | null`

Who is emailed when the endpoint fails.

> [!NOTE]
>
> 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."`.

> [!NOTE]
>
> An endpoint or delivery outside your API key's scope returns `404`, the same as one that does not exist.

```bash cURL theme={null}
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"
}'
```

```javascript JavaScript theme={null}
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"
  })
});
```

```python Python theme={null}
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"
    }
)
```

```json 200 theme={null}
{
  "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" }
```

```json 400 theme={null}
{ "error": "invalid_request", "error_description": "Invalid request body",
  "details": [ { "code": "invalid_type", "expected": "string", "received": "number", "path": ["name"], "message": "Expected string, received number" } ] }
```

```json 404 theme={null}
{ "error": "not_found", "error_description": "Webhook endpoint not found." }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.