Version: Next

RESTPostAPIGuildsJSONBody

https://discord.com/developers/docs/resources/guild#create-guild

@deprecated: API and gateway v8 are deprecated and the types will not receive further updates, please update to v10.

Index

Properties

afk_channel_id
afk_timeout
channels
default_message_notifications
explicit_content_filter
icon
name
premium_progress_bar_enabled
region
roles
system_channel_flags
system_channel_id
verification_level

Properties

optionalafk_channel_id

afk_channel_id?: null | string | number

ID for afk channel

optionalafk_timeout

afk_timeout?: number

AFK timeout in seconds

optionalchannels

channels?: APIGuildCreatePartialChannel[]

New guild’s channels

When using the channels parameter, the position field is ignored, and none of the default channels are created.

When using the channels parameter, the id field within each channel object may be set to an integer placeholder, and will be replaced by the API upon consumption. Its purpose is to allow you to create GUILD_CATEGORY channels by setting the parent_id field on any children to the category’s id field. Category channels must be listed before any children.

See https://discord.com/developers/docs/resources/channel#channel-object

optionaldefault_message_notifications

default_message_notifications?: GuildDefaultMessageNotifications

Default message notification level

See https://discord.com/developers/docs/resources/guild#guild-object-default-message-notification-level

optionalexplicit_content_filter

explicit_content_filter?: GuildExplicitContentFilter

Explicit content filter level

See https://discord.com/developers/docs/resources/guild#guild-object-explicit-content-filter-level

optionalicon

icon?: string

base64 1024x1024 png/jpeg image for the guild icon

See https://discord.com/developers/docs/reference#image-data

name

name: string

Name of the guild (2-100 characters)

optionalpremium_progress_bar_enabled

premium_progress_bar_enabled?: boolean

Whether the boosts progress bar should be enabled.

optionalregion

region?: string

Voice region id

See https://discord.com/developers/docs/resources/voice#voice-region-object

optionalroles

roles?: APIGuildCreateRole[]

New guild roles

When using this parameter, the first member of the array is used to change properties of the guild’s @everyone role. If you are trying to bootstrap a guild with additional roles, keep this in mind.

When using this parameter, the required id field within each role object is an integer placeholder, and will be replaced by the API upon consumption. Its purpose is to allow you to overwrite a role’s permissions in a channel when also passing in channels with the channels array.

See https://discord.com/developers/docs/topics/permissions#role-object