# SendGrid webhook events

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

These pages cover the Event Webhook, which reports on email you send. Inbound Parse, which posts email you receive as `multipart/form-data`, has no event types and is covered in [the Production guide](/webhooks/sendgrid/guide-duplicates-ordering-retries-timeouts#inbound-parse).

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

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [SendGrid's official docs](https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/event).

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

## delivery

### processed

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

SendGrid accepts a message for delivery

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "pool": { … },
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "event": "processed",
    "category": "cat facts",
    "sg_event_id": "rbtnWrG1DVDGGGFHFyun0A==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.000000000000000000000"
  }
]
```

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

| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

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

### delivered

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

Receiving mail server accepts the message

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "event": "delivered",
    "category": "cat facts",
    "sg_event_id": "rWVYmVk90MjZJ9iohOBa3w==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0",
    "response": "250 OK"
  }
]
```



| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

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

### bounce

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

Receiving server refuses the message, as a hard bounce or a block

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "bounce_classification": "Invalid Address",
    "event": "bounce",
    "category": "cat facts",
    "sg_event_id": "6g4ZI7SA-xmRDv57GoPIPw==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0",
    "reason": "500 unknown recipient",
    "status": "5.0.0",
    "type": "bounce"
  }
]
```



| Key field | Type | Example |
|---|---|---|
| `[0].status` | string | `5.0.0` |
| `[0].type` | string | `bounce` |
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

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

### deferred

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

Receiving server temporarily refuses the message

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

```json
[
  {
    "email": "alex@example.com",
    "domain": "example.com",
    "from": "test@example.com",
    "timestamp": 1513299569,
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "event": "deferred",
    "category": "cat facts",
    "sg_event_id": "t7LEShmowp86DTdUW8M-GQ==",
    "sg_message_id": " 14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0"
  }
]
```

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

| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

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

### dropped

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

SendGrid drops the message, for example for a previously bounced address

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "event": "dropped",
    "category": "cat facts",
    "sg_event_id": "zmzJhfJgAfUSOW80yEbPyw==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0",
    "reason": "Bounced Address",
    "status": "5.0.0"
  }
]
```



| Key field | Type | Example |
|---|---|---|
| `[0].status` | string | `5.0.0` |
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

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

## engagement

### open

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

HTML message is opened, including Apple Mail Privacy Protection opens

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "event": "open",
    "sg_machine_open": false,
    "category": "cat facts",
    "sg_event_id": "FOTFFO0ecsBE-zxFXfs6WA==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0",
    "useragent": "Mozilla/4.0 (compatible; MSIE 6.1; Windows XP; .NET CLR 1.1.4322; .NET CLR 2.0.50727)",
    "ip": "255.255.255.255"
  }
]
```



| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

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

### click

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

Recipient clicks a tracked link

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

```json
[
  {
    "sg_event_id": "sendgrid_internal_event_id",
    "sg_message_id": "sendgrid_internal_message_id",
    "ip": "255.255.255.255",
    "useragent": "Mozilla/5.0 (iPhone; CPU iPhone OS 7_1_2 like Mac OS X) AppleWebKit/537.51.2 (KHTML, like Gecko) Version/7.0 Mobile/11D257 Safari/9537.53",
    "event": "click",
    "email": "email@example.com",
    "timestamp": 1249948800,
    "url": "http://example.com/blog/news.html",
    "url_offset": { … }
  }
]
```

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

| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1249948800` |

From SendGrid docs: content type `application/json`

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

### unsubscribe

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

Recipient opts out of all your email

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "event": "unsubscribe",
    "category": "cat facts",
    "sg_event_id": "zz_BjPgU_5pS-J8vlfB1sg==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0"
  }
]
```



| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

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

### spamreport

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

Recipient reports the message as spam

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "event": "spamreport",
    "sg_event_id": "37nvH5QBz858KGVYCM4uOA==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0"
  }
]
```



| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

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

### group_unsubscribe

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

Recipient leaves a single unsubscribe group

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "event": "group_unsubscribe",
    "category": "cat facts",
    "sg_event_id": "ahSCB7xYcXFb-hEaawsPRw==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0",
    "useragent": "Mozilla/4.0 (compatible; MSIE 6.1; Windows XP; .NET CLR 1.1.4322; .NET CLR 2.0.50727)",
    "ip": "255.255.255.255"
  }
]
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/sendgrid/events/group-unsubscribe.json)

| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/sendgrid/events/group-unsubscribe.json)

### group_resubscribe

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

Recipient rejoins a single unsubscribe group

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

```json
[
  {
    "email": "alex@example.com",
    "timestamp": 1513299569,
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "event": "group_resubscribe",
    "category": "cat facts",
    "sg_event_id": "w_u0vJhLT-OFfprar5N93g==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0",
    "useragent": "Mozilla/4.0 (compatible; MSIE 6.1; Windows XP; .NET CLR 1.1.4322; .NET CLR 2.0.50727)",
    "ip": "255.255.255.255"
  }
]
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/sendgrid/events/group-resubscribe.json)

| Key field | Type | Example |
|---|---|---|
| `[0].timestamp` | number | `1513299569` |

From SendGrid docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/sendgrid/events/group-resubscribe.json)

## Other SendGrid events

### account_status_change

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

Compliance action changes your SendGrid account's status

Identified by: event field in the body · Object: `account_status_change`

```json
[
  {
    "event": "account_status_change",
    "sg_event_id": "MjEzNTg5OTcyOC10ZXJtaW5hdGUtMTcwNzg1MTUzMQ",
    "timestamp": 1709142428,
    "type": "compliance_suspend"
  }
]
```



| Key field | Type | Example |
|---|---|---|
| `[0].type` | string | `compliance_suspend` |
| `[0].timestamp` | number | `1709142428` |

From SendGrid docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/sendgrid/events/account-status-change.json)

---

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