discord_create_scheduled_event
Create a scheduled Discord event for a server, including voice, stage, or external events; provide channel or location and start/end times as required.
Instructions
Create a scheduled event. For 'VOICE'/'STAGE_INSTANCE' events provide channel_id; for 'EXTERNAL' events provide location AND scheduled_end_time. Requires the Manage Events permission. Returns the new event's name and ID.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"guild_id": "<guild_id>",
"name": "<name>",
"entity_type": "<entity_type>",
"scheduled_start_time": "<scheduled_start_time>"
},
"name": "discord_create_scheduled_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Event name (max 100 characters). | |
| image | No | Optional cover image URL. | |
| guild_id | Yes | Discord server (guild) ID (snowflake). | |
| location | No | Free-text location (e.g. a URL or place). Required for EXTERNAL events. | |
| channel_id | No | Voice or stage channel ID (snowflake). Required for VOICE/STAGE_INSTANCE events. | |
| description | No | Optional event description (max 1000 characters). | |
| entity_type | Yes | Where the event happens: 'VOICE' or 'STAGE_INSTANCE' (needs channel_id), or 'EXTERNAL' (needs location + scheduled_end_time). | |
| scheduled_end_time | No | Event end as an ISO 8601 datetime. Required for EXTERNAL events. | |
| scheduled_start_time | Yes | Event start as an ISO 8601 datetime, e.g. '2026-06-01T20:00:00Z'. Must be in the future. |