List webhooks
discord_
Read-only
- Toolset
- Webhooks
webhooks - Discord permission
- Manage Webhooks
- Context cost
- 340 tokens, estimated1,361 bytes of definition, divided by 4
List the webhooks in a single channel or across a whole server (id, name, channel, token when visible, creator). Provide channel_id or guild_id; when both are given, only channel_id is used. Requires the Manage Webhooks permission. SECURITY: a returned token lets anyone post as that webhook; treat it as a secret. Pass the id and token to discord_, or create a webhook with discord_.
Risk and annotations
Read-onlyreadOnlyHint | yes | Does not modify your server. |
|---|---|---|
DestructivedestructiveHint | n/a | Not declared: it only applies to tools that write. |
IdempotentidempotentHint | n/a | Not declared. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| channel_ | string | pattern ^\d{17,20}$ | ID (snowflake) of a channel to list webhooks for. Takes precedence over guild_id. |
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake) to list all webhooks for. Ignored when channel_id is given. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| webhooksrequired | array of objects |
| id (nested, level 1)required | string |
| name (nested, level 1)required | string or null |
| channel_ | string |
| token (nested, level 1)required | string or null |
| creator (nested, level 1)required | string or null |
Related tools
Named in its description
-
Send webhook message, Write
discord_send_ webhook_ message -
Create webhook, Write
discord_create_ webhook
Also in Webhooks
Raw definition (1,361 bytes)
{
"name": "discord_list_webhooks",
"description": "List the webhooks in a single channel or across a whole server (id, name, channel, token when visible, creator). Provide channel_id or guild_id; when both are given, only channel_id is used. Requires the Manage Webhooks permission. SECURITY: a returned token lets anyone post as that webhook; treat it as a secret. Pass the id and token to discord_send_webhook_message, or create a webhook with discord_create_webhook.",
"inputSchema": {
"type": "object",
"properties": {
"channel_id": {
"description": "ID (snowflake) of a channel to list webhooks for. Takes precedence over guild_id.",
"type": "string",
"pattern": "^\\d{17,20}$"
},
"guild_id": {
"description": "Discord server (guild) ID (snowflake) to list all webhooks for. Ignored when channel_id is given.",
"type": "string",
"pattern": "^\\d{17,20}$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"webhooks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"channel_id": {
"type": "string"
},
"token": {
"type": [
"string",
"null"
]
},
"creator": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"channel_id",
"token",
"creator"
],
"additionalProperties": false
}
}
},
"required": [
"webhooks"
],
"additionalProperties": false
},
"annotations": {
"title": "List webhooks",
"readOnlyHint": true,
"openWorldHint": true
}
}