Get started
First request
Health check, then list inboxes and read mail with curl.
Base URL: https://api.tropmail.com/api/v1
1. Health
No key required.
curl -sS https://api.tropmail.com/api/v1/health2. List inboxes this key can see
curl -sS https://api.tropmail.com/api/v1/mailboxes \
-H "Authorization: Bearer $TROPMAIL_API_KEY" \
-H "Accept: application/json"Responses use { success, message, data, error }. data.mailboxes is the array of inbox summaries. Use an id from that list on every mail request.
3. List open emails
MAILBOX_ID=11111111-1111-1111-1111-111111111111
curl -sS "https://api.tropmail.com/api/v1/mailbox/${MAILBOX_ID}/emails?limit=10&page=1&status=Open" \
-H "Authorization: Bearer $TROPMAIL_API_KEY" \
-H "Accept: application/json"4. Read one message (text)
EMAIL_ID=550e8400-e29b-41d4-a716-446655440001
curl -sS "https://api.tropmail.com/api/v1/mailbox/${MAILBOX_ID}/emails/${EMAIL_ID}/text" \
-H "Authorization: Bearer $TROPMAIL_API_KEY" \
-H "Accept: application/json"Pass timestamp from the list item as a query parameter when you have it. Markdown is generated on demand.
The same flow in the SDKs: list inboxes, then pass that id on every mail call.
Agents can do this over MCP instead — Claude Code and Cursor setup.
See the API reference.