Skip to main content
POST
/
channels
/
{channel_id}
/
messages
/
{message_id}
/
threads
cURL
curl --request POST \
  --url https://discord.com/api/v10/channels/{channel_id}/messages/{message_id}/threads \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "auto_archive_duration": "<unknown>",
  "rate_limit_per_user": 10800
}
'
{
  "id": "<string>",
  "type": 10,
  "flags": 123,
  "guild_id": "<string>",
  "name": "<string>",
  "owner_id": "<string>",
  "thread_metadata": {
    "archived": true,
    "archive_timestamp": "2023-11-07T05:31:56Z",
    "auto_archive_duration": 123,
    "locked": true,
    "create_timestamp": "2023-11-07T05:31:56Z",
    "invitable": true
  },
  "message_count": 123,
  "member_count": 123,
  "total_message_sent": 123,
  "last_message_id": "<unknown>",
  "last_pin_timestamp": "2023-11-07T05:31:56Z",
  "parent_id": "<unknown>",
  "rate_limit_per_user": 123,
  "bitrate": 123,
  "user_limit": 123,
  "rtc_region": "<string>",
  "video_quality_mode": 123,
  "permissions": "<string>",
  "applied_tags": [
    "<string>"
  ],
  "member": {
    "id": "<string>",
    "user_id": "<string>",
    "join_timestamp": "2023-11-07T05:31:56Z",
    "flags": 123,
    "member": {
      "avatar": "<string>",
      "banner": "<string>",
      "communication_disabled_until": "2023-11-07T05:31:56Z",
      "flags": 123,
      "joined_at": "2023-11-07T05:31:56Z",
      "nick": "<string>",
      "pending": true,
      "premium_since": "2023-11-07T05:31:56Z",
      "roles": [
        "<string>"
      ],
      "user": {
        "id": "<string>",
        "username": "<string>",
        "avatar": "<string>",
        "discriminator": "<string>",
        "public_flags": 123,
        "flags": 0,
        "global_name": "<string>",
        "primary_guild": "<unknown>",
        "bot": true,
        "system": true,
        "banner": "<string>",
        "accent_color": 123,
        "avatar_decoration_data": "<unknown>",
        "collectibles": "<unknown>"
      },
      "mute": true,
      "deaf": true,
      "avatar_decoration_data": "<unknown>",
      "collectibles": "<unknown>"
    }
  }
}

Authorizations

Authorization
string
header
required

Discord bot token

Path Parameters

channel_id
string<snowflake>
required
message_id
string<snowflake>
required

Body

application/json
name
string
required
Required string length: 1 - 100
auto_archive_duration

One hour

rate_limit_per_user
integer | null
Required range: 0 <= x <= 21600

Response

201 response for create_thread_from_message

id
string<snowflake>
required
type
required

A temporary sub-channel within a GUILD_ANNOUNCEMENT channel

Available options:
TitleConst
ANNOUNCEMENT_THREAD10
PUBLIC_THREAD11
PRIVATE_THREAD12
flags
integer<int32>
required
guild_id
string<snowflake>
required
name
string
required
owner_id
string<snowflake>
required
thread_metadata
object
required
message_count
integer<int32>
required
member_count
integer<int32>
required
total_message_sent
integer<int32>
required
last_message_id
null | string<snowflake>
last_pin_timestamp
string<date-time> | null
parent_id
null | string<snowflake>
rate_limit_per_user
integer<int32>
bitrate
integer<int32>
user_limit
integer<int32>
rtc_region
string | null
video_quality_mode

Discord chooses the quality for optimal performance

permissions
string | null
applied_tags
string<snowflake>[]
member
object