Appearance
The inbound email object
A message your domain received. Returned by Retrieve an inbound email; the list and the email.receivedwebhook carry the same fields without the bodies and headers.
json
{
"object": "inbound_email",
"id": "0f6d2a8e-3b1c-4c9a-9f2e-7a5d1b8c4e21",
"mailbox": "support@inbound.example.com",
"message_id": "CAF3xk2Q@mail.sender.example",
"thread_id": "6a1e9c30-2d4b-4f7e-8b5a-0c9d3e2f1a47",
"from": "alice@sender.example",
"from_name": "Alice",
"to": ["support@inbound.example.com"],
"cc": [],
"subject": "Invoice for March",
"received_at": "2026-09-16T08:41:12+00:00",
"spam_verdict": "PASS",
"virus_verdict": "PASS",
"attachments": [
{
"id": "8e0fd050-661f-4b3c-8178-c4f291d1f751",
"filename": "invoice.pdf",
"content_type": "application/pdf",
"size": 20418,
"withheld": false
}
],
"reply_to": [],
"text": "Hi, the invoice is attached.",
"html": "<p>Hi, the invoice is attached.</p>",
"headers": [{ "name": "Subject", "value": "Invoice for March" }],
"spf_verdict": "PASS",
"dkim_verdict": "PASS",
"dmarc_verdict": "PASS"
}| Field | Type | Description |
|---|---|---|
object | string | Always "inbound_email". |
id | string | The inbound email's id — a UUID. |
mailbox | string | null | The SendGrail mailbox that received it — *@inbound.example.com for the catch-all, null once receiving is turned off for the domain. |
message_id | string | null | The RFC Message-ID the sender gave the message. |
thread_id | string | null | Shared by every message in the same conversation. |
from, from_name | string | The sender's address and display name. |
to, cc, reply_to | string[] | Addresses from the message's headers. |
subject | string | null | |
received_at | string | ISO 8601. |
spam_verdict, virus_verdict, spf_verdict, dkim_verdict, dmarc_verdict | string | null | PASS, FAIL, GRAY or PROCESSING_FAILED, from the scan on arrival. |
attachments | object[] | Names and sizes — never the bytes. withheld is true when the message failed the virus scan and the file was not kept. Download through Retrieve an attachment. |
text, html | string | null | The bodies. Retrieve only. |
headers | object[] | Every header, as { name, value }. Retrieve only. |
The content is the sender's
Everything in a received message was written by whoever sent it. Treat html as untrusted — never insert it into a page without sanitising it.