Guilds

Create guild

Only claimed, email-verified non-bot users can create guilds.

post/guilds

Request body

namestring required

The name of the guild (1-100 characters)

iconstring

empty_featuresboolean

Whether to create the guild without default features

Response

Success

idstring snowflake required

namestring required

The name of the guild

iconstring nullable

The hash of the guild icon

bannerstring nullable

The hash of the guild banner

banner_widthinteger

banner_heightinteger

splashstring nullable

The hash of the guild splash screen

splash_widthinteger

splash_heightinteger

splash_card_alignment0 | 1 | 2 required

The alignment of the splash card

embed_splashstring nullable

The hash of the embedded invite splash

embed_splash_widthinteger

embed_splash_heightinteger

vanity_url_codestring nullable

The vanity URL code for the guild

owner_idstring snowflake required

system_channel_idstring snowflake

system_channel_flagsinteger required

System channel message flags

rules_channel_idstring snowflake

afk_channel_idstring snowflake

afk_timeoutinteger required

featuresGuildFeatureSchema[] required

Array of guild feature flags

verification_level0 | 1 | 2 | 3 | 4 required

Required verification level for members

mfa_level0 | 1 required

Required MFA level for moderation actions

nsfw_level0 | 3 required

The NSFW level of the guild

nsfwboolean required

Whether the guild is marked as adult (18+) content

content_warning_level0 | 1 required

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

content_warning_textstring nullable

Custom guild-wide content warning text; null falls back to a localized default

explicit_content_filter0 | 1 | 2 required

Level of content filtering for explicit media

default_message_notifications0 | 1 required

Default notification level for new members

disabled_operationsinteger required

Bitfield of disabled operations in the guild

message_history_cutoffstring date-time nullable

ISO8601 timestamp controlling how far back members without Read Message History can access messages. When null, no historical access is allowed.

permissionsstring int64

Permission bitfield as string

member_countinteger

online_countinteger

approximate_member_countinteger

approximate_presence_countinteger

Changes

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

Sep 21, 20263c2f66ec8e7b1See the full diff
- ▲
  the response property // became nullable for the status
  response-property-became-nullable
Sep 18, 2026dd0ad4ea1c882223See 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 string 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 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 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
- ○
  response property banner 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 channels/items/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 channels/items/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 channels/items/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 channels/items/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 channels/items/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 channels/items/topic 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 content_warning_text 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 embed_splash 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 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 roles/items/unicode_emoji 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 splash 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 vanity_url_code 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
- ○
  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
Sep 6, 2026a52a2cf49d9b32See 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.
Sep 5, 20264dbb738a3e224See 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
Sep 3, 2026fa36b1b48ca520See 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.

Full history