Payload version 1

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 through the API. This is the payload version of all endpoints until you choose another one.

Example

{
  "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": "[email protected]",
    "recipient": "[email protected]",
    "message_id": "<[email protected]>",
    "size_bytes": 14557,
    "sha256": "2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae",
    "expires_at": "2026-10-28T16:00:00Z"
  },
  "download": {
    "url": "https://…",
    "expires_at": "2026-10-21T17:00:00Z"
  }
}

Fields

integer

required

Always 1 for this version.

string

required

Always message.received.

string

required

Stable ID of this delivery, the same as in the X-Talario-Delivery-Id header. Use it for deduplication.

object

required

Hide properties

string

required

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

string

required

The receiving domain.

string

required

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

string

required

The SMTP envelope sender. Empty for a null sender.

string

required

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

string

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

integer

required

Size of the original message in bytes.

string

required

SHA-256 of the original message, as hex.

string

required

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

object

required

Hide properties

string

required

Download link for the original message.

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.

Get started

Receiving email

Webhooks

Payload version 1

Example

Fields

​Example

​Fields

Example

Fields