Update webhook
Update webhook URL, events, or other configuration. Use to add/remove event subscriptions or change callback URL.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Webhook identifier |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | No | Updated webhook name (1-255 chars) |
filters | object | No | Address filters: { fromAddresses: [], toAddresses: [] } (each item: 0x + 40 hex) |
filters.fromAddresses | array of string | No | Filter by sender addresses (empty = no filter) |
filters.toAddresses | array of string | No | Filter by recipient addresses (empty = no filter) |
secret | string | No | New webhook secret for rotation (min length: 1) |
Use Cases
- Update webhook URL when endpoint changes
- Add or remove event subscriptions
- Update signing secret
- Enable or disable webhook
Required Permission
webhooks:update
Update webhook
Update webhook URL, events, or other configuration. Use to add/remove event subscriptions or change callback URL.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Webhook identifier |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | No | Updated webhook name (1-255 chars) |
filters | object | No | Address filters: { fromAddresses: [], toAddresses: [] } (each item: 0x + 40 hex) |
filters.fromAddresses | array of string | No | Filter by sender addresses (empty = no filter) |
filters.toAddresses | array of string | No | Filter by recipient addresses (empty = no filter) |
secret | string | No | New webhook secret for rotation (min length: 1) |
Use Cases
- Update webhook URL when endpoint changes
- Add or remove event subscriptions
- Update signing secret
- Enable or disable webhook
Required Permission
webhooks:update