Create channel
discord_
Write
- Toolset
- Channels
channels - Discord permission
- Manage Channels
- Context cost
- 269 tokens, estimated1,074 bytes of definition, divided by 4
Create a text channel, voice channel, or category in a server. Requires the Manage Channels permission. For forum channels use discord_ instead. Returns the new channel's name and ID.
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 |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake) to create the channel in. |
| namerequired | string | none | Name of the new channel (max 100 characters). |
| typeoptional | string | one of "text""voice""category" | Channel type to create. Defaults to 'text'. |
| topicoptional | string | none | Optional channel topic/description. Applies to text channels only. |
| category_ | string | pattern ^\d{17,20}$ | Optional category (snowflake) to nest the new channel under. |
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 Channels
-
Delete channel, Destructive
discord_delete_ channel -
Edit channel, Write
discord_edit_ channel -
Move channel, Write
discord_move_ channel -
Clone channel, Write
discord_clone_ channel -
Set channel position, Write
discord_set_ channel_ position -
Follow announcement channel, Write
discord_follow_ announcement_ channel -
Sync channel permissions, Write
discord_lock_ channel_ permissions
Raw definition (1,074 bytes)
{
"name": "discord_create_channel",
"description": "Create a text channel, voice channel, or category in a server. Requires the Manage Channels permission. For forum channels use discord_create_forum_channel instead. Returns the new channel's name and ID.",
"inputSchema": {
"type": "object",
"properties": {
"guild_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord server (guild) ID (snowflake) to create the channel in."
},
"name": {
"type": "string",
"description": "Name of the new channel (max 100 characters)."
},
"type": {
"description": "Channel type to create. Defaults to 'text'.",
"type": "string",
"enum": [
"text",
"voice",
"category"
]
},
"topic": {
"description": "Optional channel topic/description. Applies to text channels only.",
"type": "string"
},
"category_id": {
"description": "Optional category (snowflake) to nest the new channel under.",
"type": "string",
"pattern": "^\\d{17,20}$"
}
},
"required": [
"guild_id",
"name"
],
"additionalProperties": false
},
"annotations": {
"title": "Create channel",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
}