create_guild_scheduled_event
Create a stage, voice, or external scheduled event in a Discord server; set start and end times, channel, privacy, image, and location for external events.
Instructions
Create a scheduled event (stage, voice or external). For external events set entity_metadata {location} and scheduled_end_time. [POST /guilds/{guild_id}/scheduled-events]
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>",
"privacy_level": "<privacy_level>",
"scheduled_start_time": "<scheduled_start_time>",
"entity_type": "<entity_type>"
},
"name": "create_guild_scheduled_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name | |
| image | No | Image: local file path, http(s) URL or data: URI | |
| reason | No | Reason (shown in the audit log) | |
| guild_id | Yes | Server (guild) ID | |
| channel_id | No | Channel ID | |
| description | No | Description | |
| entity_type | Yes | Event type: 1 = stage, 2 = voice, 3 = external (somewhere else) | |
| privacy_level | Yes | Privacy level: 2 = guild only | |
| entity_metadata | No | For external events: {"location": "..."} | |
| recurrence_rule | No | ||
| scheduled_end_time | No | End time (ISO8601, required for external events) (ISO8601 time) | |
| scheduled_start_time | Yes | Start time (ISO8601) (ISO8601 time) |