{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Mailgun.",
  "vendor": "mailgun",
  "name": "Mailgun",
  "official_docs": "https://documentation.mailgun.com/docs/mailgun/user-manual/events/event-structure.md",
  "docs_checked": "2026-10-29",
  "url": "https://hookdeck.com/webhooks/mailgun",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/mailgun"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/mailgun/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/mailgun/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/mailgun/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/mailgun/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/mailgun/skill"
    }
  ],
  "summary": "Mailgun signs every webhook with signature.signature (HMAC-SHA256, hex).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature field",
      "value": "signature.signature",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Mailgun docs",
        "href": "https://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/securing-webhooks.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256, hex",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Mailgun docs",
        "href": "https://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/securing-webhooks.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{timestamp}{token}",
      "detail": "signature.timestamp followed by signature.token, with no separator. event-data isn't signed.",
      "source": {
        "kind": "vendor-docs",
        "label": "Mailgun docs",
        "href": "https://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/securing-webhooks.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "event-data.event field in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Mailgun docs",
        "href": "https://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/securing-webhooks.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "Mailgun docs",
        "href": "https://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/webhook-payloads.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "signature, event-data",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Mailgun docs",
        "href": "https://documentation.mailgun.com/docs/mailgun/user-manual/events/event-structure.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill mailgun-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/mailgun/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/webhooks.md",
    "checked": "2026-11-04"
  },
  "counts": {
    "events": 9,
    "with_payload": 9,
    "captured": 0,
    "with_description": 9,
    "resources": 2,
    "confidence": {
      "verified": 0,
      "documented": 9,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any Mailgun event"
  },
  "events": [
    {
      "name": "accepted",
      "resource": "delivery",
      "description": "Mailgun accepts a send request and queues the message",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#accepted",
      "json": "https://hookdeck.com/webhooks/mailgun/events/accepted.json"
    },
    {
      "name": "delivered",
      "resource": "delivery",
      "description": "Recipient's mail server accepts the message",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#delivered",
      "json": "https://hookdeck.com/webhooks/mailgun/events/delivered.json"
    },
    {
      "name": "failed",
      "resource": "delivery",
      "description": "Delivery fails, with severity set to permanent or temporary",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#failed",
      "json": "https://hookdeck.com/webhooks/mailgun/events/failed.json"
    },
    {
      "name": "permanent_fail",
      "resource": "delivery",
      "description": "Permanent delivery failure, sent as failed with severity permanent",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#permanent_fail",
      "json": "https://hookdeck.com/webhooks/mailgun/events/permanent-fail.json"
    },
    {
      "name": "temporary_fail",
      "resource": "delivery",
      "description": "Temporary delivery failure, sent as failed with severity temporary",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#temporary_fail",
      "json": "https://hookdeck.com/webhooks/mailgun/events/temporary-fail.json"
    },
    {
      "name": "opened",
      "resource": "engagement",
      "description": "Recipient opens the message, with open tracking on",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#opened",
      "json": "https://hookdeck.com/webhooks/mailgun/events/opened.json"
    },
    {
      "name": "clicked",
      "resource": "engagement",
      "description": "Recipient clicks a tracked link",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#clicked",
      "json": "https://hookdeck.com/webhooks/mailgun/events/clicked.json"
    },
    {
      "name": "unsubscribed",
      "resource": "engagement",
      "description": "Recipient clicks the unsubscribe link, with unsubscribe tracking on",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#unsubscribed",
      "json": "https://hookdeck.com/webhooks/mailgun/events/unsubscribed.json"
    },
    {
      "name": "complained",
      "resource": "engagement",
      "description": "Recipient reports the message as spam through a feedback loop",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/mailgun/events#complained",
      "json": "https://hookdeck.com/webhooks/mailgun/events/complained.json"
    }
  ]
}