Sign in
Guilds

Create guild channel

Create guild channel. Requires manage_channels permission. Creates a new text, voice, or category channel in the guild.

post/guilds/{guild_id}/channels

Path parameters

string snowflake required
OR
integer required

The ID of the guild

Request body

OR
OR
OR

Response

Success

idstring snowflake required
guild_idstring snowflake
namestring nullable

The name of the channel

topicstring nullable

The topic of the channel

urlstring uri nullable

The URL associated with the channel

iconstring nullable

The icon hash of the channel (for group DMs)

owner_idstring snowflake
type0 | 1 | 2 | 3 | 4 | 998 | 999 required

The type of the channel

positioninteger
parent_idstring snowflake
bitrateinteger
user_limitinteger
voice_connection_limitinteger
rtc_regionstring nullable

The voice region ID for the voice channel

last_message_idstring snowflake
last_pin_timestampstring date-time nullable

The ISO 8601 timestamp of when the last pinned message was pinned

nsfwboolean

Whether the channel is marked as NSFW (effective value, walking channel → category → guild)

nsfw_overrideboolean nullable

Per-channel adult-content override; null means inherit from parent category and then guild. Categories use this same field as their own override.

content_warning_level0 | 1

The content warning level for a guild, category, or channel

content_warning_textstring nullable

Custom channel content warning text (max 200 characters); null inherits from parent or guild

rate_limit_per_userinteger
nicksobject

Custom nicknames for users in this channel (for group DMs)

Changes

Changed in 5 of the 21 revisions of this API.193243

  • 3c2f66ec8e7b1See the full diff
    • ▲

      the response property became nullable for the status

      response-property-became-nullable

  • dd0ad4ea1c881819See the full diff
    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      request property //// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property // became nullable for the status

      response-property-became-nullable

    • ▲

      the response property // became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      the request property //// became nullable

      request-property-became-nullable

    • ○

      response property icon list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property nsfw_override list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property recipients/items/avatar list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property recipients/items/global_name list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property rtc_region list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property topic list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      the / response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status

      response-property-pattern-changed

  • a52a2cf49d9b32See the full diff
    • ●

      added the new IP_BAN_DECLINED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new IP_BAN_DECLINED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new IP_BAN_DECLINED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new IP_BAN_DECLINED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status

      response-property-enum-value-added

    This revision's changelog hit the recording limit, so it may not list every change to this endpoint.

  • 4dbb738a3e224See the full diff
    • ○

      removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status

      response-property-enum-value-removed

  • fa36b1b48ca520See the full diff
    • ○

      removed the INVALID_PACK_TYPE enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the INVALID_PACK_TYPE enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the INVALID_PACK_TYPE enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the INVALID_PACK_TYPE enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the MAX_PACKS enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the MAX_PACKS enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the MAX_PACKS enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the MAX_PACKS enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the PACK_ACCESS_DENIED enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the PACK_ACCESS_DENIED enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the PACK_ACCESS_DENIED enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the PACK_ACCESS_DENIED enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the UNKNOWN_PACK enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the UNKNOWN_PACK enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the UNKNOWN_PACK enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the UNKNOWN_PACK enum value from the response property for the response status

      response-property-enum-value-removed

    This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 21 revisions, 2 have no diff computed.