SecureTempMail
Developer API

Temporary Email API

A small, predictable REST API to create inboxes and read mail programmatically. Built for automated end-to-end testing and integrations. Full Swagger / OpenAPI spec ships with the Developer plan.

Bearer auth

Authenticate with an API key or a per-inbox read token.

Webhooks

Get each new message POSTed to your endpoint in real time.

Rate limits

Generous limits; 100k requests/month on the Developer plan.

Quick start

# 1. Create an inbox
curl -X POST https://api.securetempmail.com/v1/inboxes \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ttlMinutes": 60 }'

# => { "id": "inb_123", "address": "swift.falcon1234@securetempmail.com", "token": "..." }

# 2. Poll for messages
curl https://api.securetempmail.com/v1/inboxes/inb_123/messages \
  -H "Authorization: Bearer $API_KEY"

Endpoints

POST/v1/inboxes

Create a new disposable inbox. Returns id, address, and a read token.

{ "ttlMinutes": 60, "domain": "securetempmail.com" }
GET/v1/inboxes/{id}

Fetch inbox metadata and expiry.

GET/v1/inboxes/{id}/messages

List messages (newest first). Supports ?since= for polling.

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

Read a full message including HTML, text, and attachments.

DELETE/v1/inboxes/{id}

Delete an inbox and all of its messages immediately.

POST/v1/addresses/generate

Generate a random available address without creating an inbox.

Ready to build?

Grab an API key on the Developer plan and start automating in minutes.

Get API access