events_create
events_create
Section titled “events_create”Category: events
Create a new scheduled event for a guild.
When to use
Section titled “When to use”- Schedule a stage, voice, or external event in a guild.
When NOT to use
Section titled “When NOT to use”| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Guild to create the event in |
name | string | yes | Event name (1-100 chars) |
privacy_level | number | yes | Always 2 (GUILD_ONLY) |
scheduled_start_time | string | yes | ISO 8601 timestamp when the event starts |
entity_type | unknown | yes | 1=STAGE_INSTANCE, 2=VOICE, 3=EXTERNAL |
channel_id | string | no | Required for STAGE/VOICE; must be a stage or voice channel |
entity_metadata | object | no | Required for EXTERNAL events; location is the venue text |
scheduled_end_time | string | no | ISO 8601 end timestamp (required for EXTERNAL) |
description | string | no | Event description (max 1000 chars) |
image | unknown | no | Cover image as base64 data URI, or null |
recurrence_rule | object | no | Recurrence rule object (see Discord docs) |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{id, name, scheduled_start_time, status, entity_type, channel_id, creator_id\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | Discord scheduled event ID |
guild_id | string | yes | Discord guild (server) ID |
name | string | yes | |
description | unknown | yes | |
scheduled_start_time | string | yes | |
scheduled_end_time | unknown | yes | |
status | integer | yes | |
entity_type | integer | yes | |
channel_id | unknown | yes | |
creator_id | unknown | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | no |