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.

$ 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"]
}

Fair-use limits apply. Inboxes expire after 30 minutes — same rules as the web app.