# Mailgun webhook events

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

These pages cover event webhooks, which report on email you send. Inbound Routes, which post email you receive through `forward()` and `store()` actions, have no event types and are covered in [the Production guide](/webhooks/mailgun/guide-duplicates-ordering-retries-timeouts#inbound-routes).

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

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Mailgun's official docs](https://documentation.mailgun.com/docs/mailgun/user-manual/events/event-structure.md).

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

## delivery

### accepted

Confidence: documented · Schema: official schema

Mailgun accepts a send request and queues the message

Identified by: event-data.event field in the body · Object: `delivery`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/accepted.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/accepted.json)

### delivered

Confidence: documented · Schema: official schema

Recipient's mail server accepts the message

Identified by: event-data.event field in the body · Object: `delivery`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/delivered.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/delivered.json)

### failed

Confidence: documented · Schema: official schema

Delivery fails, with severity set to permanent or temporary

Identified by: event-data.event field in the body · Object: `delivery`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/failed.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/failed.json)

### permanent_fail

Confidence: documented · Schema: official schema

Permanent delivery failure, sent as failed with severity permanent

Identified by: event-data.event field in the body · Object: `delivery`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/permanent-fail.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/permanent-fail.json)

### temporary_fail

Confidence: documented · Schema: official schema

Temporary delivery failure, sent as failed with severity temporary

Identified by: event-data.event field in the body · Object: `delivery`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/temporary-fail.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/temporary-fail.json)

## engagement

### opened

Confidence: documented · Schema: official schema

Recipient opens the message, with open tracking on

Identified by: event-data.event field in the body · Object: `engagement`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/opened.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/opened.json)

### clicked

Confidence: documented · Schema: official schema

Recipient clicks a tracked link

Identified by: event-data.event field in the body · Object: `engagement`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/clicked.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/clicked.json)

### unsubscribed

Confidence: documented · Schema: official schema

Recipient clicks the unsubscribe link, with unsubscribe tracking on

Identified by: event-data.event field in the body · Object: `engagement`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/unsubscribed.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/unsubscribed.json)

### complained

Confidence: documented · Schema: official schema

Recipient reports the message as spam through a feedback loop

Identified by: event-data.event field in the body · Object: `engagement`

```json
{
  "signature": { … },
  "event-data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/mailgun/events/complained.json)

From Mailgun docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/mailgun/events/complained.json)

---

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