---
title: "POST /guilds/{guild_id}/scheduled-events"
method: POST
path: "/guilds/{guild_id}/scheduled-events"
---

# POST /guilds/{guild_id}/scheduled-events

`POST /guilds/{guild_id}/scheduled-events`

## Request body

- union
  - ExternalScheduledEventCreateRequest
    - `name` string, required
    - `description` string, nullable
    - `image` string, byte, nullable
    - `scheduled_start_time` string, date-time, required
    - `scheduled_end_time` string, date-time, nullable
    - `privacy_level` 2, required — the scheduled event is only accessible to guild members
    - `entity_type` union, required
      - 0
      - 1
      - 2
      - 3
    - `channel_id` string, snowflake
    - `recurrence_rule` RecurrenceRule
      - `start` string, date-time, required — Starting time of the recurrence interval
      - `end` string, date-time, nullable — Ending time of the recurrence interval
      - `frequency` union, required
        - 3
        - 2
        - 1
        - 0
      - `interval` integer, nullable — The spacing between events, defined by frequency
      - `by_weekday` RecurrenceRuleWeekdays[], nullable — Set of specific days within a week for the event to recur on
        - union
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_n_weekday` ByNWeekday[], nullable — List of specific days within a specific week to recur on
        - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week)
        - `day` union, required
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_month` RecurrenceRuleMonths[], nullable — Set of specific months to recur on
        - union
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 9
          - 10
          - 11
          - 12
      - `by_month_day` integer[], nullable — Set of specific dates within a month to recur on
      - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364)
      - `count` integer, nullable — Total number of times the event is allowed to recur
    - `entity_metadata` EntityMetadataExternal, required
      - `location` string, required
  - StageScheduledEventCreateRequest
    - `name` string, required
    - `description` string, nullable
    - `image` string, byte, nullable
    - `scheduled_start_time` string, date-time, required
    - `scheduled_end_time` string, date-time, nullable
    - `privacy_level` 2, required — the scheduled event is only accessible to guild members
    - `entity_type` union, required
      - 0
      - 1
      - 2
      - 3
    - `channel_id` string, snowflake
    - `recurrence_rule` RecurrenceRule
      - `start` string, date-time, required — Starting time of the recurrence interval
      - `end` string, date-time, nullable — Ending time of the recurrence interval
      - `frequency` union, required
        - 3
        - 2
        - 1
        - 0
      - `interval` integer, nullable — The spacing between events, defined by frequency
      - `by_weekday` RecurrenceRuleWeekdays[], nullable — Set of specific days within a week for the event to recur on
        - union
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_n_weekday` ByNWeekday[], nullable — List of specific days within a specific week to recur on
        - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week)
        - `day` union, required
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_month` RecurrenceRuleMonths[], nullable — Set of specific months to recur on
        - union
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 9
          - 10
          - 11
          - 12
      - `by_month_day` integer[], nullable — Set of specific dates within a month to recur on
      - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364)
      - `count` integer, nullable — Total number of times the event is allowed to recur
    - `entity_metadata` EntityMetadataStageInstance
  - VoiceScheduledEventCreateRequest
    - `name` string, required
    - `description` string, nullable
    - `image` string, byte, nullable
    - `scheduled_start_time` string, date-time, required
    - `scheduled_end_time` string, date-time, nullable
    - `privacy_level` 2, required — the scheduled event is only accessible to guild members
    - `entity_type` union, required
      - 0
      - 1
      - 2
      - 3
    - `channel_id` string, snowflake
    - `recurrence_rule` RecurrenceRule
      - `start` string, date-time, required — Starting time of the recurrence interval
      - `end` string, date-time, nullable — Ending time of the recurrence interval
      - `frequency` union, required
        - 3
        - 2
        - 1
        - 0
      - `interval` integer, nullable — The spacing between events, defined by frequency
      - `by_weekday` RecurrenceRuleWeekdays[], nullable — Set of specific days within a week for the event to recur on
        - union
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_n_weekday` ByNWeekday[], nullable — List of specific days within a specific week to recur on
        - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week)
        - `day` union, required
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_month` RecurrenceRuleMonths[], nullable — Set of specific months to recur on
        - union
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 9
          - 10
          - 11
          - 12
      - `by_month_day` integer[], nullable — Set of specific dates within a month to recur on
      - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364)
      - `count` integer, nullable — Total number of times the event is allowed to recur
    - `entity_metadata` EntityMetadataVoice

## Response `200`

200 response for create_guild_scheduled_event

- union
  - ExternalScheduledEventResponse
    - `id` string, snowflake, required
    - `guild_id` string, snowflake, required
    - `name` string, required — Name of the scheduled event
    - `description` string, nullable, required — Description of the scheduled event
    - `channel_id` string, snowflake, required
    - `creator_id` string, snowflake, required
    - `creator` UserResponse
      - `id` string, snowflake, required
      - `username` string, required — the user's username, not unique across the platform
      - `avatar` string, nullable, required — the user's avatar hash
      - `discriminator` string, required — the user's Discord-tag
      - `public_flags` integer, required — the public flags on a user's account
      - `flags` integer, required
      - `bot` boolean — whether the user belongs to an OAuth2 application
      - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
      - `banner` string, nullable — the user's banner hash
      - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
      - `global_name` string, nullable, required — the user's display name, if it is set
      - `avatar_decoration_data` UserAvatarDecorationResponse
        - `asset` string, required — the avatar decoration hash
        - `sku_id` string, snowflake, required
      - `collectibles` UserCollectiblesResponse
        - `nameplate` UserNameplateResponse, required
          - `sku_id` string, snowflake, required
          - `asset` string, required — Path to the nameplate asset
          - `label` string, required — The label of this nameplate. Currently unused
          - `palette` union, required
            - 'crimson' — Crimson color palette
            - 'berry' — Berry color palette
            - 'sky' — Sky color palette
            - 'teal' — Teal color palette
            - 'forest' — Forest color palette
            - 'bubble_gum' — Bubble gum color palette
            - 'violet' — Violet color palette
            - 'cobalt' — Cobalt color palette
            - 'clover' — Clover color palette
            - 'lemon' — Lemon color palette
            - 'white' — White color palette
            - 'black' — Black color palette
      - `primary_guild` UserPrimaryGuildResponse, required
        - `identity_guild_id` string, snowflake, required
        - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
        - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
        - `badge` string, nullable, required — the server tag badge hash
    - `image` string, nullable, required — Cover image hash of the scheduled event
    - `scheduled_start_time` string, date-time, required — When the scheduled event will start
    - `scheduled_end_time` string, date-time, nullable, required — When the scheduled event will end, or null if no end time
    - `status` union, required
      - 1
      - 2
      - 3
      - 4
    - `entity_type` union, required
      - 0
      - 1
      - 2
      - 3
    - `entity_id` string, snowflake, required
    - `recurrence_rule` RecurrenceRuleResponse, required
      - `start` string, date-time, required — Starting time of the recurrence interval
      - `end` string, date-time, nullable — Ending time of the recurrence interval
      - `frequency` union, required
        - 3
        - 2
        - 1
        - 0
      - `interval` integer, required — The spacing between events, defined by frequency
      - `by_weekday` RecurrenceRuleWeekdays[], nullable, required — Set of specific days within a week for the event to recur on
        - union
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_n_weekday` ByNWeekdayResponse[], nullable, required — List of specific days within a specific week to recur on
        - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week)
        - `day` union, required
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on
        - union
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 9
          - 10
          - 11
          - 12
      - `by_month_day` integer[], nullable, required — Set of specific dates within a month to recur on
      - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364)
      - `count` integer, nullable — Total number of times the event is allowed to recur
    - `user_count` integer — Number of users subscribed to the scheduled event
    - `privacy_level` 2, required — the scheduled event is only accessible to guild members
    - `user_rsvp` ScheduledEventUserResponse
      - `guild_scheduled_event_id` string, snowflake, required
      - `guild_scheduled_event_exception_id` string, snowflake
      - `user_id` string, snowflake, required
      - `user` UserResponse
        - `id` string, snowflake, required
        - `username` string, required — the user's username, not unique across the platform
        - `avatar` string, nullable, required — the user's avatar hash
        - `discriminator` string, required — the user's Discord-tag
        - `public_flags` integer, required — the public flags on a user's account
        - `flags` integer, required
        - `bot` boolean — whether the user belongs to an OAuth2 application
        - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
        - `banner` string, nullable — the user's banner hash
        - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
        - `global_name` string, nullable, required — the user's display name, if it is set
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `primary_guild` UserPrimaryGuildResponse, required
          - `identity_guild_id` string, snowflake, required
          - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
          - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
          - `badge` string, nullable, required — the server tag badge hash
      - `member` GuildMemberResponse
        - `avatar` string, nullable, required — the member's guild avatar hash
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `banner` string, nullable, required — the member's guild banner hash
        - `communication_disabled_until` string, date-time, nullable, required — when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out
        - `flags` integer, required — guild member flags represented as a bit set, defaults to 0
        - `joined_at` string, date-time, required — when the user joined the guild
        - `nick` string, nullable, required — this user's guild nickname
        - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements
        - `premium_since` string, date-time, nullable, required — when the user started boosting the guild
        - `roles` SnowflakeType[], required — array of role object ids
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `user` UserResponse, required
          - `id` string, snowflake, required
          - `username` string, required — the user's username, not unique across the platform
          - `avatar` string, nullable, required — the user's avatar hash
          - `discriminator` string, required — the user's Discord-tag
          - `public_flags` integer, required — the public flags on a user's account
          - `flags` integer, required
          - `bot` boolean — whether the user belongs to an OAuth2 application
          - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
          - `banner` string, nullable — the user's banner hash
          - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
          - `global_name` string, nullable, required — the user's display name, if it is set
          - `avatar_decoration_data` UserAvatarDecorationResponse
            - `asset` string, required — the avatar decoration hash
            - `sku_id` string, snowflake, required
          - `collectibles` UserCollectiblesResponse
            - `nameplate` UserNameplateResponse, required
              - …
          - `primary_guild` UserPrimaryGuildResponse, required
            - `identity_guild_id` string, snowflake, required
            - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
            - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
            - `badge` string, nullable, required — the server tag badge hash
        - `mute` boolean, required — whether the user is muted in voice channels
        - `deaf` boolean, required — whether the user is deafened in voice channels
      - `response` union, required
        - 0 — User is not interested in the event
        - 1 — User is interested in the event
    - `guild_scheduled_event_exceptions` GuildScheduledEventExceptionResponse[], required
      - `event_id` string, snowflake, required
      - `event_exception_id` string, snowflake, required
      - `scheduled_start_time` string, date-time, nullable, required — Overridden start time of this occurrence
      - `scheduled_end_time` string, date-time, nullable, required — Overridden end time of this occurrence
      - `is_canceled` boolean, required — Whether this occurrence is canceled
    - `entity_metadata` EntityMetadataExternalResponse, required
      - `location` string, required — Location of the external event
  - StageScheduledEventResponse
    - `id` string, snowflake, required
    - `guild_id` string, snowflake, required
    - `name` string, required — Name of the scheduled event
    - `description` string, nullable, required — Description of the scheduled event
    - `channel_id` string, snowflake, required
    - `creator_id` string, snowflake, required
    - `creator` UserResponse
      - `id` string, snowflake, required
      - `username` string, required — the user's username, not unique across the platform
      - `avatar` string, nullable, required — the user's avatar hash
      - `discriminator` string, required — the user's Discord-tag
      - `public_flags` integer, required — the public flags on a user's account
      - `flags` integer, required
      - `bot` boolean — whether the user belongs to an OAuth2 application
      - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
      - `banner` string, nullable — the user's banner hash
      - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
      - `global_name` string, nullable, required — the user's display name, if it is set
      - `avatar_decoration_data` UserAvatarDecorationResponse
        - `asset` string, required — the avatar decoration hash
        - `sku_id` string, snowflake, required
      - `collectibles` UserCollectiblesResponse
        - `nameplate` UserNameplateResponse, required
          - `sku_id` string, snowflake, required
          - `asset` string, required — Path to the nameplate asset
          - `label` string, required — The label of this nameplate. Currently unused
          - `palette` union, required
            - 'crimson' — Crimson color palette
            - 'berry' — Berry color palette
            - 'sky' — Sky color palette
            - 'teal' — Teal color palette
            - 'forest' — Forest color palette
            - 'bubble_gum' — Bubble gum color palette
            - 'violet' — Violet color palette
            - 'cobalt' — Cobalt color palette
            - 'clover' — Clover color palette
            - 'lemon' — Lemon color palette
            - 'white' — White color palette
            - 'black' — Black color palette
      - `primary_guild` UserPrimaryGuildResponse, required
        - `identity_guild_id` string, snowflake, required
        - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
        - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
        - `badge` string, nullable, required — the server tag badge hash
    - `image` string, nullable, required — Cover image hash of the scheduled event
    - `scheduled_start_time` string, date-time, required — When the scheduled event will start
    - `scheduled_end_time` string, date-time, nullable, required — When the scheduled event will end, or null if no end time
    - `status` union, required
      - 1
      - 2
      - 3
      - 4
    - `entity_type` union, required
      - 0
      - 1
      - 2
      - 3
    - `entity_id` string, snowflake, required
    - `recurrence_rule` RecurrenceRuleResponse, required
      - `start` string, date-time, required — Starting time of the recurrence interval
      - `end` string, date-time, nullable — Ending time of the recurrence interval
      - `frequency` union, required
        - 3
        - 2
        - 1
        - 0
      - `interval` integer, required — The spacing between events, defined by frequency
      - `by_weekday` RecurrenceRuleWeekdays[], nullable, required — Set of specific days within a week for the event to recur on
        - union
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_n_weekday` ByNWeekdayResponse[], nullable, required — List of specific days within a specific week to recur on
        - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week)
        - `day` union, required
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on
        - union
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 9
          - 10
          - 11
          - 12
      - `by_month_day` integer[], nullable, required — Set of specific dates within a month to recur on
      - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364)
      - `count` integer, nullable — Total number of times the event is allowed to recur
    - `user_count` integer — Number of users subscribed to the scheduled event
    - `privacy_level` 2, required — the scheduled event is only accessible to guild members
    - `user_rsvp` ScheduledEventUserResponse
      - `guild_scheduled_event_id` string, snowflake, required
      - `guild_scheduled_event_exception_id` string, snowflake
      - `user_id` string, snowflake, required
      - `user` UserResponse
        - `id` string, snowflake, required
        - `username` string, required — the user's username, not unique across the platform
        - `avatar` string, nullable, required — the user's avatar hash
        - `discriminator` string, required — the user's Discord-tag
        - `public_flags` integer, required — the public flags on a user's account
        - `flags` integer, required
        - `bot` boolean — whether the user belongs to an OAuth2 application
        - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
        - `banner` string, nullable — the user's banner hash
        - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
        - `global_name` string, nullable, required — the user's display name, if it is set
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `primary_guild` UserPrimaryGuildResponse, required
          - `identity_guild_id` string, snowflake, required
          - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
          - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
          - `badge` string, nullable, required — the server tag badge hash
      - `member` GuildMemberResponse
        - `avatar` string, nullable, required — the member's guild avatar hash
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `banner` string, nullable, required — the member's guild banner hash
        - `communication_disabled_until` string, date-time, nullable, required — when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out
        - `flags` integer, required — guild member flags represented as a bit set, defaults to 0
        - `joined_at` string, date-time, required — when the user joined the guild
        - `nick` string, nullable, required — this user's guild nickname
        - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements
        - `premium_since` string, date-time, nullable, required — when the user started boosting the guild
        - `roles` SnowflakeType[], required — array of role object ids
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `user` UserResponse, required
          - `id` string, snowflake, required
          - `username` string, required — the user's username, not unique across the platform
          - `avatar` string, nullable, required — the user's avatar hash
          - `discriminator` string, required — the user's Discord-tag
          - `public_flags` integer, required — the public flags on a user's account
          - `flags` integer, required
          - `bot` boolean — whether the user belongs to an OAuth2 application
          - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
          - `banner` string, nullable — the user's banner hash
          - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
          - `global_name` string, nullable, required — the user's display name, if it is set
          - `avatar_decoration_data` UserAvatarDecorationResponse
            - `asset` string, required — the avatar decoration hash
            - `sku_id` string, snowflake, required
          - `collectibles` UserCollectiblesResponse
            - `nameplate` UserNameplateResponse, required
              - …
          - `primary_guild` UserPrimaryGuildResponse, required
            - `identity_guild_id` string, snowflake, required
            - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
            - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
            - `badge` string, nullable, required — the server tag badge hash
        - `mute` boolean, required — whether the user is muted in voice channels
        - `deaf` boolean, required — whether the user is deafened in voice channels
      - `response` union, required
        - 0 — User is not interested in the event
        - 1 — User is interested in the event
    - `guild_scheduled_event_exceptions` GuildScheduledEventExceptionResponse[], required
      - `event_id` string, snowflake, required
      - `event_exception_id` string, snowflake, required
      - `scheduled_start_time` string, date-time, nullable, required — Overridden start time of this occurrence
      - `scheduled_end_time` string, date-time, nullable, required — Overridden end time of this occurrence
      - `is_canceled` boolean, required — Whether this occurrence is canceled
    - `entity_metadata` EntityMetadataStageInstanceResponse, required
  - VoiceScheduledEventResponse
    - `id` string, snowflake, required
    - `guild_id` string, snowflake, required
    - `name` string, required — Name of the scheduled event
    - `description` string, nullable, required — Description of the scheduled event
    - `channel_id` string, snowflake, required
    - `creator_id` string, snowflake, required
    - `creator` UserResponse
      - `id` string, snowflake, required
      - `username` string, required — the user's username, not unique across the platform
      - `avatar` string, nullable, required — the user's avatar hash
      - `discriminator` string, required — the user's Discord-tag
      - `public_flags` integer, required — the public flags on a user's account
      - `flags` integer, required
      - `bot` boolean — whether the user belongs to an OAuth2 application
      - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
      - `banner` string, nullable — the user's banner hash
      - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
      - `global_name` string, nullable, required — the user's display name, if it is set
      - `avatar_decoration_data` UserAvatarDecorationResponse
        - `asset` string, required — the avatar decoration hash
        - `sku_id` string, snowflake, required
      - `collectibles` UserCollectiblesResponse
        - `nameplate` UserNameplateResponse, required
          - `sku_id` string, snowflake, required
          - `asset` string, required — Path to the nameplate asset
          - `label` string, required — The label of this nameplate. Currently unused
          - `palette` union, required
            - 'crimson' — Crimson color palette
            - 'berry' — Berry color palette
            - 'sky' — Sky color palette
            - 'teal' — Teal color palette
            - 'forest' — Forest color palette
            - 'bubble_gum' — Bubble gum color palette
            - 'violet' — Violet color palette
            - 'cobalt' — Cobalt color palette
            - 'clover' — Clover color palette
            - 'lemon' — Lemon color palette
            - 'white' — White color palette
            - 'black' — Black color palette
      - `primary_guild` UserPrimaryGuildResponse, required
        - `identity_guild_id` string, snowflake, required
        - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
        - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
        - `badge` string, nullable, required — the server tag badge hash
    - `image` string, nullable, required — Cover image hash of the scheduled event
    - `scheduled_start_time` string, date-time, required — When the scheduled event will start
    - `scheduled_end_time` string, date-time, nullable, required — When the scheduled event will end, or null if no end time
    - `status` union, required
      - 1
      - 2
      - 3
      - 4
    - `entity_type` union, required
      - 0
      - 1
      - 2
      - 3
    - `entity_id` string, snowflake, required
    - `recurrence_rule` RecurrenceRuleResponse, required
      - `start` string, date-time, required — Starting time of the recurrence interval
      - `end` string, date-time, nullable — Ending time of the recurrence interval
      - `frequency` union, required
        - 3
        - 2
        - 1
        - 0
      - `interval` integer, required — The spacing between events, defined by frequency
      - `by_weekday` RecurrenceRuleWeekdays[], nullable, required — Set of specific days within a week for the event to recur on
        - union
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_n_weekday` ByNWeekdayResponse[], nullable, required — List of specific days within a specific week to recur on
        - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week)
        - `day` union, required
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
      - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on
        - union
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 9
          - 10
          - 11
          - 12
      - `by_month_day` integer[], nullable, required — Set of specific dates within a month to recur on
      - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364)
      - `count` integer, nullable — Total number of times the event is allowed to recur
    - `user_count` integer — Number of users subscribed to the scheduled event
    - `privacy_level` 2, required — the scheduled event is only accessible to guild members
    - `user_rsvp` ScheduledEventUserResponse
      - `guild_scheduled_event_id` string, snowflake, required
      - `guild_scheduled_event_exception_id` string, snowflake
      - `user_id` string, snowflake, required
      - `user` UserResponse
        - `id` string, snowflake, required
        - `username` string, required — the user's username, not unique across the platform
        - `avatar` string, nullable, required — the user's avatar hash
        - `discriminator` string, required — the user's Discord-tag
        - `public_flags` integer, required — the public flags on a user's account
        - `flags` integer, required
        - `bot` boolean — whether the user belongs to an OAuth2 application
        - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
        - `banner` string, nullable — the user's banner hash
        - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
        - `global_name` string, nullable, required — the user's display name, if it is set
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `primary_guild` UserPrimaryGuildResponse, required
          - `identity_guild_id` string, snowflake, required
          - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
          - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
          - `badge` string, nullable, required — the server tag badge hash
      - `member` GuildMemberResponse
        - `avatar` string, nullable, required — the member's guild avatar hash
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `banner` string, nullable, required — the member's guild banner hash
        - `communication_disabled_until` string, date-time, nullable, required — when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out
        - `flags` integer, required — guild member flags represented as a bit set, defaults to 0
        - `joined_at` string, date-time, required — when the user joined the guild
        - `nick` string, nullable, required — this user's guild nickname
        - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements
        - `premium_since` string, date-time, nullable, required — when the user started boosting the guild
        - `roles` SnowflakeType[], required — array of role object ids
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `user` UserResponse, required
          - `id` string, snowflake, required
          - `username` string, required — the user's username, not unique across the platform
          - `avatar` string, nullable, required — the user's avatar hash
          - `discriminator` string, required — the user's Discord-tag
          - `public_flags` integer, required — the public flags on a user's account
          - `flags` integer, required
          - `bot` boolean — whether the user belongs to an OAuth2 application
          - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
          - `banner` string, nullable — the user's banner hash
          - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
          - `global_name` string, nullable, required — the user's display name, if it is set
          - `avatar_decoration_data` UserAvatarDecorationResponse
            - `asset` string, required — the avatar decoration hash
            - `sku_id` string, snowflake, required
          - `collectibles` UserCollectiblesResponse
            - `nameplate` UserNameplateResponse, required
              - …
          - `primary_guild` UserPrimaryGuildResponse, required
            - `identity_guild_id` string, snowflake, required
            - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
            - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
            - `badge` string, nullable, required — the server tag badge hash
        - `mute` boolean, required — whether the user is muted in voice channels
        - `deaf` boolean, required — whether the user is deafened in voice channels
      - `response` union, required
        - 0 — User is not interested in the event
        - 1 — User is interested in the event
    - `guild_scheduled_event_exceptions` GuildScheduledEventExceptionResponse[], required
      - `event_id` string, snowflake, required
      - `event_exception_id` string, snowflake, required
      - `scheduled_start_time` string, date-time, nullable, required — Overridden start time of this occurrence
      - `scheduled_end_time` string, date-time, nullable, required — Overridden end time of this occurrence
      - `is_canceled` boolean, required — Whether this occurrence is canceled
    - `entity_metadata` EntityMetadataVoiceResponse, required

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

- **2026-06-05** `693bf1f99bba` — 12 breaking, 15 info
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `oneOf[#/components/schemas/ExternalScheduledEventResponse]/creator/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `oneOf[#/components/schemas/ExternalScheduledEventResponse]/user_rsvp/oneOf[#/components/schemas/ScheduledEventUserResponse]/member/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `oneOf[#/components/schemas/ExternalScheduledEventResponse]/user_rsvp/oneOf[#/components/schemas/ScheduledEventUserResponse]/member/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `oneOf[#/components/schemas/ExternalScheduledEventResponse]/user_rsvp/oneOf[#/components/schemas/ScheduledEventUserResponse]/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - …23 more
- …earlier changes not shown

[Full history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/scheduled-events/post.md)

---

[API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/9fd91c50cf32/schema)