API reference

A REST API for creating inboxes and reading messages programmatically.

Base URL

https://www.newtempemail.site/api/v1

Authentication

Every request needs an API key in the Authorization header, created from your account's API keys page. Keys are scoped to your account and rate-limited per your plan.

curl https://www.newtempemail.site/api/v1/inboxes \
  -H "Authorization: Bearer tm_live_xxxxxxxxxxxxxxxx"

Get an API key

Endpoints

GET/inboxesList your inboxes

POST/inboxesCreate a new inbox

GET/inboxes/{id}Get inbox details

DELETE/inboxes/{id}Delete an inbox and all its messages

GET/inboxes/{id}/messagesList messages in an inbox

GET/inboxes/{id}/messages/{messageId}Get one message (sanitized HTML/text/headers)

DELETE/inboxes/{id}/messages/{messageId}Delete a message

GET/inboxes/{id}/messages/{messageId}/attachments/{attachmentId}Get a short-lived signed download URL for an attachment

Rate limits

Each plan has a published per-minute request budget, enforced per account and shared across every key you hold — creating additional keys does not increase your total budget. See the pricing page for exact numbers. Responses include standard rate-limit headers.

Idempotency

Pass an Idempotency-Key header on POST requests to safely retry a request without creating a duplicate inbox.