Features

Mailbox

Mailboxes group messages inside an account. The default system folders support webmail-style workflows while custom mailboxes let tests organize traffic.

System mailboxes

Every account starts with five default system mailboxes: INBOX, Sent, Trash, Drafts, and Junk. System mailboxes are created automatically when an account is created.

curl https://stmp.ink/api/accounts/1/mailboxes \
  -H "X-API-KEY: $SMTPDEV_API_KEY"

Custom mailboxes

Create a mailbox by posting a path. The API returns per-mailbox metadata including whether it is a system mailbox, total messages, and unread messages.

curl -X POST https://stmp.ink/api/accounts/1/mailboxes \
  -H "X-API-KEY: $SMTPDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"Promotions"}'

Counts

Mailbox JSON includes totalMessages and totalUnreadMessages. This MVP does not yet model read/unread state separately, so unread currently mirrors the mailbox total.