Create forum post
discord_
Write
- Toolset
- Forums
forums - Discord permission
- Send Messages
- Context cost
- 264 tokens, estimated1,054 bytes of definition, divided by 4
Create a new post (a thread with a starter message) in a forum channel. Requires the Send Messages permission (Discord ignores Create Public Threads for forum posts). Use discord_ to add follow-up messages. Returns the new post's name and thread 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 |
|---|---|---|---|
| forum_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the forum channel to post in. |
| titlerequired | string | none | Title of the post, used as the thread name (max 100 characters). |
| contentrequired | string | none | Body of the post's starter message (max 2000 characters). |
| applied_ | array of strings | none | Optional tag IDs to apply. Get valid IDs from discord_get_forum_tags. |
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 Forums
-
List forum channels, Read-only
discord_get_ forum_ channels -
Create forum channel, Write
discord_create_ forum_ channel -
Get forum post, Read-only
discord_get_ forum_ post -
List forum threads, Read-only
discord_list_ forum_ threads -
Delete forum post, Destructive
discord_delete_ forum_ post -
Get forum tags, Read-only
discord_get_ forum_ tags -
Set forum tags, Destructive
discord_set_ forum_ tags -
Update forum post, Write
discord_update_ forum_ post
Raw definition (1,054 bytes)
{
"name": "discord_create_forum_post",
"description": "Create a new post (a thread with a starter message) in a forum channel. Requires the Send Messages permission (Discord ignores Create Public Threads for forum posts). Use discord_reply_to_forum to add follow-up messages. Returns the new post's name and thread ID.",
"inputSchema": {
"type": "object",
"properties": {
"forum_channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the forum channel to post in."
},
"title": {
"type": "string",
"description": "Title of the post, used as the thread name (max 100 characters)."
},
"content": {
"type": "string",
"description": "Body of the post's starter message (max 2000 characters)."
},
"applied_tags": {
"description": "Optional tag IDs to apply. Get valid IDs from discord_get_forum_tags.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"forum_channel_id",
"title",
"content"
],
"additionalProperties": false
},
"annotations": {
"title": "Create forum post",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
}