Skip to main content
Messages represent individual emails received on your domain. Each message belongs to a thread and contains sender information, recipients, subject, and a reference to its content (plain text, HTML, and raw MIME).

List messages

Retrieve a paginated list of received messages across all your inboxes. You can filter by domain or sender address.

Available filters

Retrieve a message

Get the full details of a single message by its ID. The response includes inbox information showing which inbox the message was routed to.

Message fields

Get message content

Retrieve presigned download URLs for the message body in different formats. Each content item includes the download URL, the uncompressed size in bytes, and when the URL expires. By default, only the HTML format is returned. Use the format parameter to request additional formats.
Use the format query parameter to control which formats are included in the response. Requesting only the formats you need avoids unnecessary downloads. Each of text, html, and mime is either a content item object or null if not requested or not available for the message. Each content item has the following fields:

Attachments

List attachments

Retrieve all attachments for a specific message.

Retrieve an attachment

Get a single attachment with a presigned download URL.

Attachment fields

Next steps

Inboxes

Create and manage inboxes to route incoming emails

Threads

Understand how messages are grouped into conversations

Send, reply, and forward

Respond to received messages from your inboxes