Temp Mail for Developers: A Practical API Guide

The SecureTempMail API is a small REST surface designed for automation. Here's the typical lifecycle.

Create an inbox

POST /v1/inboxes
{ "ttlMinutes": 60 }
=> { "id": "...", "address": "swift.falcon1234@securetempmail.com", "token": "..." }

Poll for messages

GET /v1/inboxes/{id}/messages
Authorization: Bearer {token}

Read a message

GET /v1/inboxes/{id}/messages/{messageId}

For event-driven flows, register a webhook and we'll POST each new message to your endpoint the moment it arrives. See the full reference on the API docs page.