Skip to main content
POST
/
guilds
/
{guild_id}
/
channels
cURL
curl --request POST \
  --url https://discord.com/api/v10/guilds/{guild_id}/channels \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<unknown>",
  "position": 1,
  "topic": "<string>",
  "bitrate": 8001,
  "user_limit": 1,
  "nsfw": true,
  "rate_limit_per_user": 10800,
  "parent_id": "<unknown>",
  "permission_overwrites": [
    {
      "id": "<string>",
      "type": "<unknown>",
      "allow": 123,
      "deny": 123
    }
  ],
  "rtc_region": "<string>",
  "video_quality_mode": "<unknown>",
  "default_auto_archive_duration": "<unknown>",
  "default_reaction_emoji": "<unknown>",
  "default_thread_rate_limit_per_user": 10800,
  "default_sort_order": "<unknown>",
  "default_forum_layout": "<unknown>",
  "default_tag_setting": "<unknown>",
  "available_tags": [
    "<unknown>"
  ]
}
'
{
  "id": "<string>",
  "type": 0,
  "flags": 123,
  "guild_id": "<string>",
  "name": "<string>",
  "position": 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>",
  "topic": "<string>",
  "default_auto_archive_duration": 123,
  "default_thread_rate_limit_per_user": 123,
  "permission_overwrites": [
    {
      "id": "<string>",
      "type": 123,
      "allow": "<string>",
      "deny": "<string>"
    }
  ],
  "nsfw": true,
  "available_tags": [
    {
      "id": "<string>",
      "name": "<string>",
      "moderated": true,
      "emoji_id": "<unknown>",
      "emoji_name": "<string>"
    }
  ],
  "default_reaction_emoji": "<unknown>",
  "default_sort_order": "<unknown>",
  "default_forum_layout": "<unknown>",
  "default_tag_setting": "<unknown>",
  "hd_streaming_until": "2023-11-07T05:31:56Z",
  "hd_streaming_buyer_id": "<string>"
}

Authorizations

Authorization
string
header
required

Discord bot token

Path Parameters

guild_id
string<snowflake>
required

Body

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

A text channel within a server

Available options:
TitleConst
GUILD_TEXT0
GUILD_VOICE2
GUILD_CATEGORY4
GUILD_ANNOUNCEMENT5
GUILD_STAGE_VOICE13
GUILD_DIRECTORY14
GUILD_FORUM15
position
integer<int32> | null
Required range: x >= 0
topic
string | null
Maximum string length: 4096
bitrate
integer<int32> | null
Required range: x >= 8000
user_limit
integer<int32> | null
Required range: x >= 0
nsfw
boolean | null
rate_limit_per_user
integer | null
Required range: 0 <= x <= 21600
parent_id
null | string<snowflake>
permission_overwrites
object[] | null
Maximum array length: 100
rtc_region
string | null
video_quality_mode

Discord chooses the quality for optimal performance

default_auto_archive_duration

One hour

default_reaction_emoji
object
default_thread_rate_limit_per_user
integer | null
Required range: 0 <= x <= 21600
default_sort_order

Sort forum posts by activity

default_forum_layout

No default has been set for forum channel

default_tag_setting

The thread tags must contain all tags in the search query

Allowed value: "match_all"
available_tags
(null | object)[] | null
Maximum array length: 20

Response

201 response for create_guild_channel

id
string<snowflake>
required
type
required

A text channel within a server

Available options:
TitleConst
GUILD_TEXT0
GUILD_VOICE2
GUILD_CATEGORY4
GUILD_ANNOUNCEMENT5
GUILD_STAGE_VOICE13
GUILD_DIRECTORY14
GUILD_FORUM15
flags
integer<int32>
required
guild_id
string<snowflake>
required
name
string
required
position
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
topic
string | null
default_auto_archive_duration

One hour

default_thread_rate_limit_per_user
integer<int32>
permission_overwrites
object[]
nsfw
boolean
available_tags
object[]
default_reaction_emoji
object
default_sort_order

Sort forum posts by activity

default_forum_layout

No default has been set for forum channel

default_tag_setting

The thread tags must contain all tags in the search query

Allowed value: "match_all"
hd_streaming_until
string<date-time>
hd_streaming_buyer_id
string<snowflake>