v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Discord

Create a Discord scheduled event

Create a guild scheduled event. Three event types, selected via the discriminator on entity.type:

  • external — off-platform (Zoom, in-person, livestream). Requires both location and endsAt. Most common type for scheduler integrations.
  • voice — hosted in a Discord voice channel. Requires channelId.
  • stage — hosted in a Discord stage channel. Requires channelId.

Bot needs MANAGE_EVENTS in the guild. Existing installs (pre-events PR) need a re-invite OR a server admin manually granting the permission — see route header for details.

post/v1/discord/guilds/{guildId}/events

Path parameters

guildIdstring required

Request body

accountIdstring required
namestring required
descriptionstring
startsAtstring date-time required

ISO 8601 start time. Must be in the future.

imageDataUristring

Optional cover image as a base64 data URI.

Response

Event created.