API reference
Mailbox messages
Operations for mailbox messages.
These endpoints take a mailbox token, not an organization API key — they act as one mailbox holder. See Authentication.
- GETList messages in a folder
/api/v1/mailbox/messages - GETRead one message
/api/v1/mailbox/messages/{message_id} - GETMessages waiting to be sent
/api/v1/mailbox/messages/scheduled - POSTSave a draft
/api/v1/mailbox/messages/draft - POSTSend a message
/api/v1/mailbox/messages/send - DELETEPermanently delete a message
/api/v1/mailbox/messages/{message_id} - GETList a message's attachments
/api/v1/mailbox/messages/{message_id}/attachments - GETWho this message is with, and the shape of its conversation
/api/v1/mailbox/messages/{message_id}/context - GETDownload the original message (RFC 822)
/api/v1/mailbox/messages/{message_id}/raw - GETThe conversation a message belongs to
/api/v1/mailbox/messages/{message_id}/thread - POSTMark a message read
/api/v1/mailbox/messages/{message_id}/mark-read - POSTMark a message unread
/api/v1/mailbox/messages/{message_id}/mark-unread - POSTMove a message to another folder
/api/v1/mailbox/messages/{message_id}/move - POSTStar a message
/api/v1/mailbox/messages/{message_id}/star - POSTMove a message to Trash
/api/v1/mailbox/messages/{message_id}/trash - POSTUnstar a message
/api/v1/mailbox/messages/{message_id}/unstar - DELETEDiscard a draft
/api/v1/mailbox/messages/draft/{message_id} - DELETECancel a scheduled send
/api/v1/mailbox/messages/scheduled/{message_id} - GETDownload one attachment
/api/v1/mailbox/messages/{message_id}/attachments/{index}