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.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

guildIdstring

Request Body

accountIdstring

namestring

Length1 <= length <= 100

description?string

Lengthlength <= 1000

startsAtstring

ISO 8601 start time. Must be in the future.

Formatdate-time

entity||

imageDataUri?string

Optional cover image as a base64 data URI.

Match^data:image/(png|jpeg|gif);base64,

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.discord.createDiscordScheduledEvent({  path: {    guildId: 'guild_abc123',  },  body: {    accountId: 'account_abc123',    name: 'Example',    startsAt: '2026-01-15T10:00:00Z',    entity: {      type: 'external',      location: 'string',      endsAt: '2026-01-15T10:00:00Z',    },  },});console.log(data);

{
  "data": {
    "id": "string",
    "guild_id": "string",
    "channel_id": "string",
    "creator_id": "string",
    "name": "string",
    "description": "string",
    "scheduled_start_time": "2019-08-24T14:15:22Z",
    "scheduled_end_time": "2019-08-24T14:15:22Z",
    "privacy_level": 2,
    "status": 1,
    "entity_type": 1,
    "entity_id": "string",
    "entity_metadata": {
      "location": "string"
    },
    "user_count": 0,
    "image": "string"
  }
}

Empty

{
  "error": "Unauthorized"
}

Empty

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.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

guildIdstring

Request Body

accountIdstring

namestring

Length1 <= length <= 100

description?string

Lengthlength <= 1000

startsAtstring

ISO 8601 start time. Must be in the future.

Formatdate-time

entity||

imageDataUri?string

Optional cover image as a base64 data URI.

Match^data:image/(png|jpeg|gif);base64,

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.discord.createDiscordScheduledEvent({
  path: {
    guildId: 'guild_abc123',
  },
  body: {
    accountId: 'account_abc123',
    name: 'Example',
    startsAt: '2026-01-15T10:00:00Z',
    entity: {
      type: 'external',
      location: 'string',
      endsAt: '2026-01-15T10:00:00Z',
    },
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.discord.createDiscordScheduledEvent({  path: {    guildId: 'guild_abc123',  },  body: {    accountId: 'account_abc123',    name: 'Example',    startsAt: '2026-01-15T10:00:00Z',    entity: {      type: 'external',      location: 'string',      endsAt: '2026-01-15T10:00:00Z',    },  },});console.log(data);

{
  "data": {
    "id": "string",
    "guild_id": "string",
    "channel_id": "string",
    "creator_id": "string",
    "name": "string",
    "description": "string",
    "scheduled_start_time": "2019-08-24T14:15:22Z",
    "scheduled_end_time": "2019-08-24T14:15:22Z",
    "privacy_level": 2,
    "status": 1,
    "entity_type": 1,
    "entity_id": "string",
    "entity_metadata": {
      "location": "string"
    },
    "user_count": 0,
    "image": "string"
  }
}

Empty

{
  "error": "Unauthorized"
}

Empty

Create a Discord scheduled event

200application/json

400

401application/json

404

502

Create a Discord scheduled event

200application/json

400

401application/json

404

502

application/json

application/json

application/json

application/json