> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talario.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Payload version 1

> Metadata and a download link for the original message.

Version 1 contains the metadata of a received message and a link to download the original message (`.eml`). Your application downloads and parses the message itself, or reads the [parsed content](/receiving/parsed-content) through the API.

This is the payload version of all endpoints until you choose another one.

## Example

```json theme={null}
{
  "schema_version": 1,
  "event": "message.received",
  "delivery_id": "019a0520-0000-7000-8000-000000000001",
  "message": {
    "id": "019a0520-0000-7000-8000-000000000002",
    "domain": "inbound.example.com",
    "received_at": "2026-10-21T16:00:00Z",
    "envelope_from": "erika@example.org",
    "recipient": "support@inbound.example.com",
    "message_id": "<external-id@example.org>",
    "size_bytes": 14557,
    "sha256": "2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae",
    "expires_at": "2026-10-28T16:00:00Z"
  },
  "download": {
    "url": "https://…",
    "expires_at": "2026-10-21T17:00:00Z"
  }
}
```

## Fields

**schema\_version** `integer` *required*

Always `1` for this version.

**event** `string` *required*

Always `message.received`.

**delivery\_id** `string` *required*

Stable ID of this delivery, the same as in the `X-Talario-Delivery-Id` header. Use it for [deduplication](/webhooks/processing#deduplication).

**message** `object` *required*

**properties**

**id** `string` *required*

Talario's ID of the message (UUIDv7). All recipients of the same domain share it.

**domain** `string` *required*

The receiving domain.

**received\_at** `string` *required*

When Talario accepted the message (ISO 8601, UTC).

**envelope\_from** `string` *required*

The SMTP envelope sender. Empty for a null sender.

**recipient** `string` *required*

The envelope recipient of this delivery, as written by the sender.

**message\_id** `string`

The `Message-ID` header, if present. Chosen by the sender; do not rely on it as an identifier.

**size\_bytes** `integer` *required*

Size of the original message in bytes.

**sha256** `string` *required*

SHA-256 of the original message, as hex.

**expires\_at** `string` *required*

End of the retention period. Afterwards the message cannot be downloaded.

**download** `object` *required*

**properties**

**url** `string` *required*

[Download link](/receiving/downloads) for the original message.

**expires\_at** `string` *required*

Expiry of the link: at most 1 hour after this attempt.

The payload contains no subject, text or attachments; they are part of the original message. Metadata is limited in length and cleaned of control characters. Ignore fields you do not know; Talario may add fields to this version.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.