Skip to main content
POST
/
stage-instances
cURL
curl --request POST \
  --url https://discord.com/api/v10/stage-instances \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "topic": "<string>",
  "channel_id": "<string>",
  "privacy_level": "<unknown>",
  "guild_scheduled_event_id": "<unknown>",
  "send_start_notification": true
}
'
{
  "guild_id": "<string>",
  "channel_id": "<string>",
  "topic": "<string>",
  "privacy_level": 123,
  "id": "<string>",
  "discoverable_disabled": true,
  "guild_scheduled_event_id": "<unknown>"
}

Authorizations

Authorization
string
header
required

Discord bot token

Body

application/json
topic
string
required
Required string length: 1 - 120
channel_id
string<snowflake>
required
privacy_level

The Stage instance is visible publicly. (deprecated)

guild_scheduled_event_id
null | string<snowflake>
send_start_notification
boolean | null

Response

200 response for create_stage_instance

guild_id
string<snowflake>
required
channel_id
string<snowflake>
required
topic
string
required
privacy_level
required

The Stage instance is visible publicly. (deprecated)

id
string<snowflake>
required
discoverable_disabled
boolean
required
guild_scheduled_event_id
null | string<snowflake>
required