webhook_list

List the server’s webhooks. Pass a channel to see only the webhooks that post there.

Request

{
  "cmd": "webhook_list",
  "channel": "general"
}

Field	Type	Required	Description
`channel`	string	No	Only list webhooks for this channel. Leave it out or send `""` to list every webhook.

Response

{
  "cmd": "webhook_list",
  "webhooks": [
    {
      "id": "3f2b8c1e-5d4a-4b7e-9c61-2a8f0e7d9b34",
      "channel": "general",
      "name": "Build reports",
      "token": "8c9e2f4a-7b1d-4e3c-a5f6-0d2b9e8c1a47f3a9c2e1b0d4f5a6",
      "created_by": "<alice's user ID>",
      "created_at": 1758700000.123,
      "avatar": null
    }
  ]
}

The fields are described on webhook_create. The list isn’t sorted.

Permissions

Requires manage_server.

Errors

`val`	When
`Channel not found`	`channel` is set but no channel has that name.
Validation message	`channel` isn’t a string.

See also