webhook_update

Change the default name or avatar that a webhook’s messages show. A post can still override both for a single message.

Request

{
  "cmd": "webhook_update",
  "id": "3f2b8c1e-5d4a-4b7e-9c61-2a8f0e7d9b34",
  "name": "Release reports",
  "avatar": "https://cdn.example.com/release.png"
}

Field	Type	Required	Description
`id`	string	Yes	Webhook ID.
`name`	string	No	New display name. Surrounding spaces are trimmed; it can’t be blank.
`avatar`	string or null	No	New avatar URL. `null` clears it. The server doesn’t check the URL.

Send name, avatar, or both. Fields you leave out stay as they are. The channel and token can’t be changed here.

Response

{
  "cmd": "webhook_update",
  "webhook": {
    "id": "3f2b8c1e-5d4a-4b7e-9c61-2a8f0e7d9b34",
    "channel": "general",
    "name": "Release reports",
    "created_by": "<alice's user ID>",
    "created_at": 1758700000.123,
    "avatar": "https://cdn.example.com/release.png"
  }
}

The fields are described on webhook_create. token is omitted. Nobody else receives a broadcast, and the change is recorded in the audit log.

Permissions

Requires manage_server. It is blocked while you are timed out.

Errors

`val`	When
`Webhook not found`	No webhook has that ID.
`No updates provided`	Neither `name` nor `avatar` was sent.
`Failed to update webhook '<name>'`	The server couldn’t save `webhooks.json`. Nothing changed.
Validation message	`id` is missing, `name` is blank, or a field has the wrong type, for example `name: Expected length at least 1`.

See also