# Discord webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/discord/mcp-events).

These pages cover the events Discord sends your app. To post messages to a channel, see [how to get started with Discord webhooks](/webhooks/platforms/how-to-get-started-with-discord-webhooks).

Agent skill: `npx skills add hookdeck/webhook-skills --skill discord-webhooks` ([details](https://hookdeck.com/webhooks/discord/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Discord's official docs](https://docs.discord.com/developers/events/webhook-events).

[Overview](https://hookdeck.com/webhooks/discord) · [Webhook events (12)](https://hookdeck.com/webhooks/discord/events) · [MCP events](https://hookdeck.com/webhooks/discord/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/discord/verify) · [Production guide](https://hookdeck.com/webhooks/discord/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/discord/skill)

## entitlement

### ENTITLEMENT_CREATE

Confidence: documented · Schema: from Discord docs (example)

User buys or receives one of your SKUs

Identified by: event.type field in the body · Object: `entitlement`

```json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/entitlement-create.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/entitlement-create.json)

### ENTITLEMENT_UPDATE

Confidence: documented · Schema: from Discord docs (example)

Entitlement changes, such as a subscription ending

Identified by: event.type field in the body · Object: `entitlement`

```json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/entitlement-update.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/entitlement-update.json)

### ENTITLEMENT_DELETE

Confidence: documented · Schema: from Discord docs (example)

Refund, Discord removal or test deletion ends an entitlement

Identified by: event.type field in the body · Object: `entitlement`

```json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/entitlement-delete.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/entitlement-delete.json)

## game_direct_message

### GAME_DIRECT_MESSAGE_CREATE

Confidence: documented · Schema: official schema

DM sent during an active Social SDK session

Identified by: event.type field in the body · Object: `game_direct_message`

```json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/game-direct-message-create.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/game-direct-message-create.json)

### GAME_DIRECT_MESSAGE_UPDATE

Confidence: documented · Schema: official schema

DM edited during an active Social SDK session

Identified by: event.type field in the body · Object: `game_direct_message`

```json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/game-direct-message-update.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/game-direct-message-update.json)

### GAME_DIRECT_MESSAGE_DELETE

Confidence: documented · Schema: official schema

DM removed during an active Social SDK session

Identified by: event.type field in the body · Object: `game_direct_message`

```json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/game-direct-message-delete.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/game-direct-message-delete.json)

## lobby_message

### LOBBY_MESSAGE_CREATE

Confidence: documented · Schema: official schema

New message posted in a lobby

Identified by: event.type field in the body · Object: `lobby_message`

```json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/lobby-message-create.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/lobby-message-create.json)

### LOBBY_MESSAGE_UPDATE

Confidence: documented · Schema: official schema

Lobby message edited

Identified by: event.type field in the body · Object: `lobby_message`

```json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/lobby-message-update.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/lobby-message-update.json)

### LOBBY_MESSAGE_DELETE

Confidence: documented · Schema: from Discord docs (example)

Lobby message removed

Identified by: event.type field in the body · Object: `lobby_message`

```json
{
  "version": 1,
  "application_id": "1234567765431056709",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/lobby-message-delete.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/lobby-message-delete.json)

## Other Discord events

### APPLICATION_AUTHORIZED

Confidence: documented · Schema: official schema

User adds your app to a server or their account

Identified by: event.type field in the body · Object: `application`

```json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/application-authorized.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/application-authorized.json)

### APPLICATION_DEAUTHORIZED

Confidence: documented · Schema: official schema

Your app loses a user's authorization

Identified by: event.type field in the body · Object: `application`

```json
{
  "version": 1,
  "application_id": "1234560123453231555",
  "type": 1,
  "event": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/discord/events/application-deauthorized.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |

[View as JSON](https://hookdeck.com/webhooks/discord/events/application-deauthorized.json)

### QUEST_USER_ENROLLMENT

Confidence: documented · Schema: No payload yet

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

Identified by: event.type field in the body · Object: `quest_user`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/discord/events/quest-user-enrollment.json)

---

Not affiliated with Discord. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/discord.json) · [Report a correction](https://hookdeck.com/contact)
