{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Discord.",
  "vendor": "discord",
  "name": "Discord",
  "official_docs": "https://docs.discord.com/developers/events/webhook-events",
  "docs_checked": "2026-10-18",
  "url": "https://hookdeck.com/webhooks/discord",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/discord"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/discord/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/discord/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/discord/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/discord/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/discord/skill"
    }
  ],
  "summary": "Discord signs every webhook with X-Signature-Ed25519 (Ed25519).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "X-Signature-Ed25519",
      "detail": "Format: <hex>",
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "Ed25519",
      "detail": "Asymmetric: verify with the vendor's public key.",
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{timestamp}{raw body}",
      "detail": "The X-Signature-Timestamp value with the raw body straight after it and no separator.",
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "event.type field in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "versioning",
      "label": "API versioning",
      "value": "version in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "timestamp",
      "label": "Send timestamp",
      "value": "X-Signature-Timestamp",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "handshake",
      "label": "URL handshake",
      "value": "POST: answer the PING",
      "detail": "Discord sends a PING with type 0 when you save the URL. Answer 204 with an empty body.",
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "version, application_id, type, event",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Discord docs",
        "href": "https://docs.discord.com/developers/events/webhook-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill discord-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/discord/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://docs.discord.com/developers/events/webhook-events",
    "checked": "2026-11-04"
  },
  "counts": {
    "events": 12,
    "with_payload": 11,
    "captured": 0,
    "with_description": 12,
    "resources": 4,
    "confidence": {
      "verified": 0,
      "documented": 12,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any Discord event"
  },
  "events": [
    {
      "name": "APPLICATION_AUTHORIZED",
      "resource": "application",
      "description": "User adds your app to a server or their account",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#APPLICATION_AUTHORIZED",
      "json": "https://hookdeck.com/webhooks/discord/events/application-authorized.json"
    },
    {
      "name": "APPLICATION_DEAUTHORIZED",
      "resource": "application",
      "description": "Your app loses a user's authorization",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#APPLICATION_DEAUTHORIZED",
      "json": "https://hookdeck.com/webhooks/discord/events/application-deauthorized.json"
    },
    {
      "name": "ENTITLEMENT_CREATE",
      "resource": "entitlement",
      "description": "User buys or receives one of your SKUs",
      "confidence": "documented",
      "schema_source": "from Discord docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#ENTITLEMENT_CREATE",
      "json": "https://hookdeck.com/webhooks/discord/events/entitlement-create.json"
    },
    {
      "name": "ENTITLEMENT_UPDATE",
      "resource": "entitlement",
      "description": "Entitlement changes, such as a subscription ending",
      "confidence": "documented",
      "schema_source": "from Discord docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#ENTITLEMENT_UPDATE",
      "json": "https://hookdeck.com/webhooks/discord/events/entitlement-update.json"
    },
    {
      "name": "ENTITLEMENT_DELETE",
      "resource": "entitlement",
      "description": "Refund, Discord removal or test deletion ends an entitlement",
      "confidence": "documented",
      "schema_source": "from Discord docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#ENTITLEMENT_DELETE",
      "json": "https://hookdeck.com/webhooks/discord/events/entitlement-delete.json"
    },
    {
      "name": "QUEST_USER_ENROLLMENT",
      "resource": "quest_user",
      "description": "User joins a Quest; apps can't receive this yet",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/discord/events#QUEST_USER_ENROLLMENT",
      "json": "https://hookdeck.com/webhooks/discord/events/quest-user-enrollment.json"
    },
    {
      "name": "LOBBY_MESSAGE_CREATE",
      "resource": "lobby_message",
      "description": "New message posted in a lobby",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#LOBBY_MESSAGE_CREATE",
      "json": "https://hookdeck.com/webhooks/discord/events/lobby-message-create.json"
    },
    {
      "name": "LOBBY_MESSAGE_UPDATE",
      "resource": "lobby_message",
      "description": "Lobby message edited",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#LOBBY_MESSAGE_UPDATE",
      "json": "https://hookdeck.com/webhooks/discord/events/lobby-message-update.json"
    },
    {
      "name": "LOBBY_MESSAGE_DELETE",
      "resource": "lobby_message",
      "description": "Lobby message removed",
      "confidence": "documented",
      "schema_source": "from Discord docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#LOBBY_MESSAGE_DELETE",
      "json": "https://hookdeck.com/webhooks/discord/events/lobby-message-delete.json"
    },
    {
      "name": "GAME_DIRECT_MESSAGE_CREATE",
      "resource": "game_direct_message",
      "description": "DM sent during an active Social SDK session",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#GAME_DIRECT_MESSAGE_CREATE",
      "json": "https://hookdeck.com/webhooks/discord/events/game-direct-message-create.json"
    },
    {
      "name": "GAME_DIRECT_MESSAGE_UPDATE",
      "resource": "game_direct_message",
      "description": "DM edited during an active Social SDK session",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#GAME_DIRECT_MESSAGE_UPDATE",
      "json": "https://hookdeck.com/webhooks/discord/events/game-direct-message-update.json"
    },
    {
      "name": "GAME_DIRECT_MESSAGE_DELETE",
      "resource": "game_direct_message",
      "description": "DM removed during an active Social SDK session",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/discord/events#GAME_DIRECT_MESSAGE_DELETE",
      "json": "https://hookdeck.com/webhooks/discord/events/game-direct-message-delete.json"
    }
  ]
}