---
title: Understanding Webhook event payloads
description: This page details the fields of the webhook event payloads for Scaleway Transactional Email
tags: spf dkim dmarc transactional
dates:
  validation: 2025-10-01
  posted: 2024-09-20
---
import WebhookEventStatus from '@macros/tem/webhook-event-status.mdx'
import WebhookEventTypes from '@macros/tem/webhook-event-types.mdx'


Events triggered by webhooks contain payloads that describe and detail the events.

Find below a detailed description of the fields in a [Webhook event](/transactional-email/how-to/create-webhooks/) payload.


|           Tag            |                                        Description                                         |
| ------------------------ | ------------------------------------------------------------------------------------------ |
| `created_at`             | Event creation date. Dates should be included in RFC-3339 format.                          |
| `domain_id`              | Domain identifier                                                                          |
| `domain_name`            | Domain name                                                                                |
| `email_error`            | **DEPRECATED** SMTP message explaining the drop                                            |
| `email_from`             | Email FROM address                                                                         |
| `email_headers`          | SMTP headers                                                                               |
| `email_id`               | Email identifier (used for GetEmail endpoint)                                              |
| `email_next_try`         | Next time the email will be sent to the recipient server                                   |
| `email_queued_at`        | Email reception date by TEM proxy or API. Dates should be included in RFC-3339 format.     |
| `email_response_code`    | SMTP response code                                                                         |
| `email_response_message` | SMTP response message                                                                      |
| `email_sent_at`          | Email reception date by the recipient server. Dates should be included in RFC-3339 format. |
| `email_to`               | Email recipient address                                                                    |
| `email_try_count`        | Total number of tries attempted for this email                                             |
| `id`                     | Event identifier                                                                           |
| `organization_id`        | Domain Organization                                                                        |
| `project_id`             | Domain Project                                                                             |
| `type`                   | Event type. Find a full list of event types in the [section below](#webhook-event-type).   |


## Webhook event type

<WebhookEventTypes />

## Webhook event status

<WebhookEventStatus />

## Examples of payload by event type

Webhooks may trigger different [event types](/transactional-email/concepts/#webhook-event-type). These types have varying payload fields.

### blocklist_created
```json
{
  "id": uuid,
  "type": "blocklist_created",
  "organization_id": uuid,
  "project_id": uuid,
  "domain_id": uuid,
  "domain_name": string,
  "created_at": time,
  "email_to": string,
  "blocklist_id": uuid,
  "blocklist_type": "mailbox_full" | "mailbox_not_found",
  "blocklist_reason": string
}
```

### email_blocklisted
```json
{
  "id": uuid,
  "type": "email_blocklisted",
  "organization_id": uuid,
  "project_id": uuid,
  "domain_id": uuid,
  "domain_name": string,
  "created_at": time,
  "email_from": string,
  "email_to": string,
  "email_headers": [
    {
      "key": string,
      "value": string,
    }
  ],
  "email_blocklisted_at": time,
  "blocklist_id": uuid,
  "blocklist_type": "mailbox_full" | "mailbox_not_found",
  "blocklist_reason": string
}
```
### email_deferred
```json
{
  "id": UUID,
  "type": "email_deferred",
  "organization_id": UUID,
  "project_id": UUID,
  "domain_id": UUID,
  "domain_name": string,
  "created_at": time,
  "email_sent_at": time,
  "email_id": UUID,
  "email_from": string,
  "email_to": string,
  "email_headers": [
    {
      "key": string,
      "value": string
    }
  ],
  "email_error": string,
  "email_next_try": time,
  "email_try_count": int,
  "email_response_code": int,
  "email_response_message": string
}
```

### email_delivered
```json
{
  "id": UUID,
  "type": "email_delivered",
  "organization_id": UUID,
  "project_id": UUID,
  "domain_id": UUID,
  "domain_name": string,
  "created_at": time,
  "email_sent_at": time,
  "email_id": UUID,
  "email_from": string,
  "email_to": string,
  "email_headers": [
    {
      "key": string,
      "value": string
    }
  ],
  "email_response_code": int,
  "email_response_message": string
}
```

### email_dropped
```json
{
  {
  "id": UUID,
  "type": "email_dropped",
  "organization_id": UUID,
  "project_id": UUID,
  "domain_id": UUID,
  "domain_name": string,
  "created_at": time,
  "email_sent_at": time,
  "email_id": UUID,
  "email_from": string,
  "email_to": string,
  "email_headers": [
    {
      "key": string,
      "value": string
    }
  ],
  "email_sent_at": time,
  "email_error": string,
  "email_response_code": int,
  "email_response_message": string
```

### email_queued
```json
{
  "id": UUID,
  "type": "email_queued",
  "organization_id": UUID,
  "project_id": UUID,
  "domain_id": UUID,
  "domain_name": string,
  "created_at": time,
  "email_queued_at": timed,
  "email_id": UUID,
  "email_from": string,
  "email_to": string,
  "email_headers": [
    {
      "key": string,
      "value": string
    }
  ]
}
```

### email_mailbox_not_found
```json
{
  "id": UUID,
  "type": "email_mailbox_not_found",
  "organization_id": UUID,
  "project_id": UUID,
  "domain_id": UUID,
  "domain_name": string,
  "created_at": time,
  "email_sent_at": time,
  "email_id": UUID,
  "email_from": string,
  "email_to": string,
  "email_headers": [
    {
      "key": string,
      "value": string
    }
  ],
  "email_response_code": int,
  "email_response_message": string
}
```

### email_spam
```json
{
  "id": UUID,
  "type": "email_spam",
  "organization_id": UUID,
  "project_id": UUID,
  "domain_id": UUID,
  "domain_name": string,
  "created_at": time,
  "email_sent_at": time,
  "email_id": UUID,
  "email_from": string,
  "email_to": string,
  "email_headers": [
    {
      "key": string,
      "value": string
    }
  ],
  "email_response_code": int,
  "email_response_message": string
}
```