Skip to content

Messages

See Reading mail and Sending mail.

Endpoint What it does
GET /inboxes/:id/messages Mail for one address, newest first, paginated with limit and cursor.
GET /messages/:id One sealed message.
GET /messages/:id/attachments/:index One sealed attachment.
POST /messages/:id/read Mark as read, or unread with { "read": false }.
POST /messages/send Send mail from an address you own. Takes from, to, subject, text and optionally html. Returns sent and a messageId. Sessions and API keys, not device credentials.
GET /workers/messages The newest mail across the calling device’s addresses, up to 200. Device credential only.