Guilds

Create guild

Changed on

Only claimed, email-verified non-bot users can create guilds. A self-hosted instance can restrict creation to admins and users granted the feature_guild_create limit.

post/guilds

Request

  • Base URL: https://web.fluxer.app/api/v1
  • URL: https://web.fluxer.app/api/v1/guilds
  • Auth: API key in header Authorization

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 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
threads_activetrue

Present and true when threads, forum and media channels are active in this guild for the requesting client. Only set on the current user guild list

Changes

  • 49a8e1f96864Revision changes
    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      the request property /// became nullable

    • info

      request property /// list-of-types was widened by adding types null to media type application/json

    • info

      request property /// list-of-types was widened by adding types null to media type application/json

  • b620d9da76aaRevision changes
    • info

      added the optional property // to the response with the status