Create webhook
discord_
Write
- Toolset
- Webhooks
webhooks - Discord permission
- Manage Webhooks
- Context cost
- 262 tokens, estimated1,046 bytes of definition, divided by 4
Create a webhook on a channel and return its ID and token. SECURITY: the returned token grants anyone the ability to post as this webhook without authentication; treat it as a secret. Requires the Manage Webhooks permission. Use the returned id+token with discord_. On a forum or media channel, discord_ cannot post through the webhook, since Discord then requires a thread.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | no | Declared non-destructive. |
IdempotentidempotentHint | no | Repeating the call can have an additional effect. |
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 the channel to attach the webhook to. |
| namerequired | string | none | Display name for the webhook (max 80 characters). |
| avataroptional | string | format uripattern ^https?:// | Optional avatar image URL for the webhook. |
Output
This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.
Related tools
Named in its description
Also in Webhooks
-
Edit webhook, Write
discord_edit_ webhook -
Delete webhook, Destructive
discord_delete_ webhook -
List webhooks, Read-only
discord_list_ webhooks -
Edit webhook message, Write
discord_edit_ webhook_ message -
Delete webhook message, Destructive
discord_delete_ webhook_ message -
Fetch webhook message, Read-only
discord_fetch_ webhook_ message
Raw definition (1,046 bytes)
{
"name": "discord_create_webhook",
"description": "Create a webhook on a channel and return its ID and token. SECURITY: the returned token grants anyone the ability to post as this webhook without authentication; treat it as a secret. Requires the Manage Webhooks permission. Use the returned id+token with discord_send_webhook_message. On a forum or media channel, discord_send_webhook_message cannot post through the webhook, since Discord then requires a thread.",
"inputSchema": {
"type": "object",
"properties": {
"channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the channel to attach the webhook to."
},
"name": {
"type": "string",
"description": "Display name for the webhook (max 80 characters)."
},
"avatar": {
"description": "Optional avatar image URL for the webhook.",
"type": "string",
"format": "uri",
"pattern": "^https?://"
}
},
"required": [
"channel_id",
"name"
],
"additionalProperties": false
},
"annotations": {
"title": "Create webhook",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
}