Receive Emails
Receive email sent to addresses on your own domain. Every message is accepted, stored, and pushed to your application as a signed JSON POST. The webhook carries the full message (bodies and attachments), so you do not need a follow-up call to read it.
Stored messages can also be browsed in the Email App (see Dashboard).
Quickstart
- Enable receiving on a domain. Add the receiving MX record, switch on the
receivingcapability and verify it. See Receive Email on a Domain. - Send a test message to any address at the domain, for example
[email protected]. - Handle the request. Verify the signature, process the JSON, and answer with a
2xxwithin 10 seconds. See Verify and delivery.
In this section
| Page | What it covers |
|---|---|
| Webhook payload | JSON body, attachments (inline or download links), size limits, HTML sanitisation. |
| Verify and delivery | Request headers, signature verification, idempotency, failures and replay. |
Dashboard
The Email App lists received emails with sender, recipient, subject and timestamp, and supports search plus timezone and time-range filters. A Receiving Address option in the page menu shows the addresses you can receive on.
Open a message to see its details and these tabs:
| Tab | Shown | Content |
|---|---|---|
| Preview | Always | Rendered message, with inline cid: images resolved. |
| Text | When the message has a plain-text body | The text body. |
| HTML | When the message has an HTML body | The sanitised HTML source. |
| Raw | Always | The stored record as JSON. |
Attachments are listed on the message and download on click. Domain capability toggles and the MX conflict warning are on the domain detail page.