Skip to content

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"
}
FieldTypeDescription
objectstringAlways "inbound_email".
idstringThe inbound email's id — a UUID.
mailboxstring | nullThe SendGrail mailbox that received it — *@inbound.example.com for the catch-all, null once receiving is turned off for the domain.
message_idstring | nullThe RFC Message-ID the sender gave the message.
thread_idstring | nullShared by every message in the same conversation.
from, from_namestringThe sender's address and display name.
to, cc, reply_tostring[]Addresses from the message's headers.
subjectstring | null
received_atstringISO 8601.
spam_verdict, virus_verdict, spf_verdict, dkim_verdict, dmarc_verdictstring | nullPASS, FAIL, GRAY or PROCESSING_FAILED, from the scan on arrival.
attachmentsobject[]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, htmlstring | nullThe bodies. Retrieve only.
headersobject[]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.

Transactional email on your own domain.