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)
ENTITLEMENT_CREATE User buys or receives one of your SKUs
Identified by event.type field in the body
Resource entitlement
{
"version": 1,
"application_id": "1234560123453231555",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 16 fields.
ENTITLEMENT_UPDATE
documented from Discord docs (example)
ENTITLEMENT_UPDATE Entitlement changes, such as a subscription ending
Identified by event.type field in the body
Resource entitlement
{
"version": 1,
"application_id": "1234560123453231555",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 16 fields.
ENTITLEMENT_DELETE
documented from Discord docs (example)
ENTITLEMENT_DELETE Refund, Discord removal or test deletion ends an entitlement
Identified by event.type field in the body
Resource entitlement
{
"version": 1,
"application_id": "1234560123453231555",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 16 fields.
game_direct_message
GAME_DIRECT_MESSAGE_CREATE
documented official schema
GAME_DIRECT_MESSAGE_CREATE DM sent during an active Social SDK session
Identified by event.type field in the body
Resource game_direct_message
{
"version": 1,
"application_id": "1234567765431056709",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 41 fields.
GAME_DIRECT_MESSAGE_UPDATE
documented official schema
GAME_DIRECT_MESSAGE_UPDATE DM edited during an active Social SDK session
Identified by event.type field in the body
Resource game_direct_message
{
"version": 1,
"application_id": "1234567765431056709",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 38 fields.
GAME_DIRECT_MESSAGE_DELETE
documented official schema
GAME_DIRECT_MESSAGE_DELETE DM removed during an active Social SDK session
Identified by event.type field in the body
Resource game_direct_message
{
"version": 1,
"application_id": "1234567765431056709",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 42 fields.
lobby_message
LOBBY_MESSAGE_CREATE
documented official schema
LOBBY_MESSAGE_CREATE New message posted in a lobby
Identified by event.type field in the body
Resource lobby_message
{
"version": 1,
"application_id": "1234567765431056709",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 41 fields.
LOBBY_MESSAGE_UPDATE
documented official schema
LOBBY_MESSAGE_UPDATE Lobby message edited
Identified by event.type field in the body
Resource lobby_message
{
"version": 1,
"application_id": "1234567765431056709",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 42 fields.
LOBBY_MESSAGE_DELETE
documented from Discord docs (example)
LOBBY_MESSAGE_DELETE Lobby message removed
Identified by event.type field in the body
Resource lobby_message
{
"version": 1,
"application_id": "1234567765431056709",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 9 fields.
Other Discord events
APPLICATION_AUTHORIZED
documented official schema
APPLICATION_AUTHORIZED User adds your app to a server or their account
Identified by event.type field in the body
{
"version": 1,
"application_id": "1234560123453231555",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 37 fields.
APPLICATION_DEAUTHORIZED
documented official schema
APPLICATION_DEAUTHORIZED Your app loses a user's authorization
Identified by event.type field in the body
{
"version": 1,
"application_id": "1234560123453231555",
"type": 1,
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
Full schema: 34 fields.
QUEST_USER_ENROLLMENT
documented No payload yet
QUEST_USER_ENROLLMENT User joins a Quest; apps can't receive this yet
Identified by event.type field in the body
No payload yet.
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.