Sign in to fill these examples with your own keys. Sign in Start free trial

Managing received emails

Poll stored mail or open it in the inbox.

Read mail that landed in an inbox, either in the dashboard or over the API.

Read mail in the dashboard

  1. In the sidebar, open Inbound → Inboxes, then select an inbox.
  2. The Mail list shows messages newest first. Select one to read it next to the list.
  3. Press J or the down arrow for the next message, and K or the up arrow for the previous one.

Each message shows its Text and HTML bodies, attachments with Download, SPF, DKIM, DMARC, and ARC results, the thread, and when it expires.

HTML opens in a sandboxed frame. Scripts and remote images are blocked.

List messages with the API

The list returns stored messages, newest first, up to 200. List rows carry attachment metadata only.

poll.sh
1curl -sS -H 'Authorization: Bearer YOUR_API_KEY' \ 2 https://app.postshiba.com/api/v1/inboxes/PqRzMn/inbound_messages

Get one message

Show returns the raw MIME and the attachment bytes while PostShiba keeps them. With retention off, both are null, and the attachment download returns 410, once the webhook delivers. Without a webhook, the bytes stay for 7 days. An expired message is deleted, so show returns 404. See Retention and storage. Fields are on Inbound messages.

show-message.sh
1curl -sS -H 'Authorization: Bearer YOUR_API_KEY' \ 2 https://app.postshiba.com/api/v1/inboxes/PqRzMn/inbound_messages/GxTyVu

Download an attachment

Attachments are numbered from 1.

download-attachment.sh
1curl -sS -H 'Authorization: Bearer YOUR_API_KEY' \ 2 --output photo.png \ 3 https://app.postshiba.com/api/v1/inboxes/PqRzMn/inbound_messages/GxTyVu/attachments/1

Every message uses the same payload as the JSON webhook.

Next steps