FastTempMail API

Authentication

The API uses two credentials. Your API key (header X-API-Key) authenticates your account and is required to create inboxes. Creating an inbox returns a readToken — a per-inbox credential you pass as Authorization: Bearer to read, stream, or delete that inbox.

Base URL: https://api.tempxzy.net/headless

Quickstart

1 · Create an inbox

curl -X POST https://api.tempxzy.net/headless/emails \
  -H "X-API-Key: $FASTTEMPMAIL_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "lifespanMinutes": 60 }'

# 201 Created
# {
#   "id": "aZ3kQ",
#   "email_address": "abc.12345@tempxzy.net",
#   "expires_at": "2026-07-24T12:34:56.000Z",
#   "readToken": "rd_9f2c..."
# }

2 · Read what it received

curl https://api.tempxzy.net/headless/emails/$ID \
  -H "Authorization: Bearer $READ_TOKEN"

# 200 OK
# {
#   "emails": [
#     { "id": 42, "content": "<raw MIME / decrypted body>", "created_at": "..." }
#   ],
#   "total": 1, "page": 1, "limit": 10, "totalPages": 1
# }

Endpoints

Real-time delivery

Open an SSE connection to /emails/:id/stream and you'll get a new-email event the instant mail arrives — then fetch it. Outbound webhooks (we POST each email to your endpoint) are rolling out for paid plans, so you never have to poll in CI.