channels_forum_create_thread
channels_forum_create_thread
Section titled “channels_forum_create_thread”Category: channels
Create a new forum (or media) thread with an initial message in one request.
When to use
Section titled “When to use”- Forum-channel onboarding flows; programmatic question/answer post creation.
When NOT to use
Section titled “When NOT to use”- Anchored thread on an existing message → use
messages_create_thread. - Plain text channels — Discord rejects.
| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Parent forum/media channel |
name | string | yes | Thread (post) name (1-100 chars) |
auto_archive_duration | unknown | no | Auto-archive after N minutes (60, 1440, 4320, or 10080) |
rate_limit_per_user | integer | no | |
applied_tags | array | no | Forum tag IDs to apply to the thread |
message | object | yes | Initial forum post body. At least one of content/embeds/components required. |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{thread_id, parent_id, message_id\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
thread_id | string | yes | Discord channel ID (snowflake) |
parent_id | unknown | yes | |
message_id | unknown | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | no |