Developers

A dead-simple JSON API

No API key, no OAuth dance. Three endpoints, plain JSON, free for personal use and testing.

GET/api/create

Create a new inbox (or reuse your current session). Add ?username=yourname for a custom address.

$ curl -c jar.txt https://webmailtemp.com/api/create

{
  "success": true,
  "email": "[email protected]",
  "username": "x7k2m9q4w1",
  "ttl": 1800
}
GET/api/check/<username>

Poll for messages. Requires the session cookie from /api/create (proves you own that inbox).

$ curl -b jar.txt https://webmailtemp.com/api/check/x7k2m9q4w1

{
  "success": true,
  "count": 1,
  "emails": [ { "from": "...", "subject": "...", "body": "..." } ]
}
GET/api/domains

List the domains currently available for new addresses.

$ curl https://webmailtemp.com/api/domains

{
  "domains": ["webmailtemp.com"]
}

Free-tier inboxes last 30 minutes. Redeem a Premium license (webmailtemp.com/#premium) in your session — via the "Have a key?" field or POST /api/premium/redeem — and the same endpoints return 30-day retention, 10 inboxes, and custom usernames automatically.