Discord webhook events

12 Discord event types in 3 resources, plus Other Discord events. 11 have sample payloads.

These pages cover the events Discord sends your app. To post messages to a channel, see how to get started with Discord webhooks.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

entitlement

ENTITLEMENT_CREATE

documented from Discord docs (example)

User buys or receives one of your SKUs

Identified by event.type field in the body Resource entitlement

discord-entitlement-create.json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 16 fields.

Send example to Inspect → View as JSON

ENTITLEMENT_UPDATE

documented from Discord docs (example)

Entitlement changes, such as a subscription ending

Identified by event.type field in the body Resource entitlement

discord-entitlement-update.json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 16 fields.

Send example to Inspect → View as JSON

ENTITLEMENT_DELETE

documented from Discord docs (example)

Refund, Discord removal or test deletion ends an entitlement

Identified by event.type field in the body Resource entitlement

discord-entitlement-delete.json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 16 fields.

Send example to Inspect → View as JSON

game_direct_message

GAME_DIRECT_MESSAGE_CREATE

documented official schema

DM sent during an active Social SDK session

Identified by event.type field in the body Resource game_direct_message

discord-game-direct-message-create.json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 41 fields.

Send example to Inspect → View as JSON

GAME_DIRECT_MESSAGE_UPDATE

documented official schema

DM edited during an active Social SDK session

Identified by event.type field in the body Resource game_direct_message

discord-game-direct-message-update.json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 38 fields.

Send example to Inspect → View as JSON

GAME_DIRECT_MESSAGE_DELETE

documented official schema

DM removed during an active Social SDK session

Identified by event.type field in the body Resource game_direct_message

discord-game-direct-message-delete.json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 42 fields.

Send example to Inspect → View as JSON

lobby_message

LOBBY_MESSAGE_CREATE

documented official schema

New message posted in a lobby

Identified by event.type field in the body Resource lobby_message

discord-lobby-message-create.json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 41 fields.

Send example to Inspect → View as JSON

LOBBY_MESSAGE_UPDATE

documented official schema

Lobby message edited

Identified by event.type field in the body Resource lobby_message

discord-lobby-message-update.json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 42 fields.

Send example to Inspect → View as JSON

LOBBY_MESSAGE_DELETE

documented from Discord docs (example)

Lobby message removed

Identified by event.type field in the body Resource lobby_message

discord-lobby-message-delete.json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 9 fields.

Send example to Inspect → View as JSON

Other Discord events

APPLICATION_AUTHORIZED

documented official schema

User adds your app to a server or their account

Identified by event.type field in the body

discord-application-authorized.json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 37 fields.

Send example to Inspect → View as JSON

APPLICATION_DEAUTHORIZED

documented official schema

Your app loses a user's authorization

Identified by event.type field in the body

discord-application-deauthorized.json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}

Key fields

Field Type Example
type integer 1

Full schema: 34 fields.

Send example to Inspect → View as JSON

QUEST_USER_ENROLLMENT

documented No payload yet

User joins a Quest; apps can't receive this yet

Identified by event.type field in the body

No payload yet.

Help fill this in → View as JSON

Route Discord events by type.

Event Gateway receives every Discord delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Discord. Facts are compiled from public sources and linked inline.