Create scheduled event
discord_
Write
- Toolset
- Scheduled events
scheduled_events - Discord permission
- Create Events
- Context cost
- 660 tokens, estimated2,641 bytes of definition, divided by 4
Create a scheduled event. For 'VOICE'/'STAGE_INSTANCE' events provide channel_id; for 'EXTERNAL' events provide location AND scheduled_end_time. Requires the Create Events permission (Manage Events alone no longer suffices), plus View Channel and Connect in the channel for VOICE events, or Manage Channels, Mute Members and Move Members for STAGE_INSTANCE events. Returns the new event's name and ID. To change, start or cancel an existing event, use discord_.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | no | Declared non-destructive. |
IdempotentidempotentHint | no | Repeating the call can have an additional effect. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
| namerequired | string | none | Event name (max 100 characters). |
| descriptionoptional | string | none | Optional event description (max 1000 characters). |
| entity_ | string | one of "VOICE""STAGE_INSTANCE""EXTERNAL" | Where the event happens: 'VOICE' or 'STAGE_INSTANCE' (needs channel_id), or 'EXTERNAL' (needs location + scheduled_end_time). |
| scheduled_ | string | format date-timepattern (288 characters)^(?:(?:\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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | Event start as an ISO 8601 datetime, e.g. '2026-06-01T20:00:00Z'. Must be in the future. |
| scheduled_ | string | format date-timepattern (288 characters)^(?:(?:\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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | Event end as an ISO 8601 datetime. Required for EXTERNAL events. |
| channel_ | string | pattern ^\d{17,20}$ | Voice or stage channel ID (snowflake). Required for VOICE/STAGE_INSTANCE events. |
| locationoptional | string | none | Free-text location (e.g. a URL or place). Required for EXTERNAL events. |
| imageoptional | string | format uripattern ^https?:// | Optional cover image URL. |
Output
This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.
Related tools
Named in its description
Also in Scheduled events
-
List scheduled events, Read-only
discord_list_ scheduled_ events -
Get scheduled event, Read-only
discord_get_ scheduled_ event -
Delete scheduled event, Destructive
discord_delete_ scheduled_ event -
Get event subscribers, Read-only
discord_get_ event_ subscribers -
Create event invite, Write
discord_create_ event_ invite
Raw definition (2,641 bytes)
{
"name": "discord_create_scheduled_event",
"description": "Create a scheduled event. For 'VOICE'/'STAGE_INSTANCE' events provide channel_id; for 'EXTERNAL' events provide location AND scheduled_end_time. Requires the Create Events permission (Manage Events alone no longer suffices), plus View Channel and Connect in the channel for VOICE events, or Manage Channels, Mute Members and Move Members for STAGE_INSTANCE events. Returns the new event's name and ID. To change, start or cancel an existing event, use discord_edit_scheduled_event.",
"inputSchema": {
"type": "object",
"properties": {
"guild_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord server (guild) ID (snowflake)."
},
"name": {
"type": "string",
"description": "Event name (max 100 characters)."
},
"description": {
"description": "Optional event description (max 1000 characters).",
"type": "string"
},
"entity_type": {
"type": "string",
"enum": [
"VOICE",
"STAGE_INSTANCE",
"EXTERNAL"
],
"description": "Where the event happens: 'VOICE' or 'STAGE_INSTANCE' (needs channel_id), or 'EXTERNAL' (needs location + scheduled_end_time)."
},
"scheduled_start_time": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "Event start as an ISO 8601 datetime, e.g. '2026-06-01T20:00:00Z'. Must be in the future."
},
"scheduled_end_time": {
"description": "Event end as an ISO 8601 datetime. Required for EXTERNAL events.",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"channel_id": {
"description": "Voice or stage channel ID (snowflake). Required for VOICE/STAGE_INSTANCE events.",
"type": "string",
"pattern": "^\\d{17,20}$"
},
"location": {
"description": "Free-text location (e.g. a URL or place). Required for EXTERNAL events.",
"type": "string"
},
"image": {
"description": "Optional cover image URL.",
"type": "string",
"format": "uri",
"pattern": "^https?://"
}
},
"required": [
"guild_id",
"name",
"entity_type",
"scheduled_start_time"
],
"additionalProperties": false
},
"annotations": {
"title": "Create scheduled event",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
}