YOUR DISPOSABLE EMAIL 🛡️ Permanent Inbox (No auto-delete)
10s

Your inbox is waiting...

Emails sent to your address will appear here automatically in real time.

Select an email from the list to view its contents

Developer REST API Documentation

REST v2.0

Programmatically generate disposable addresses, fetch inboxes, and receive webhooks for automation bots, test runners, or microservices.

GET /api/generate.php

Generate a new random email address with a 40-character recovery token.

cURL Example
curl -X GET "https://yourdomain.com/api/generate.php"
POST /api/generate.php

Create custom alias with specific domain or recover mailbox via token.

cURL Example
curl -X POST "https://yourdomain.com/api/generate.php" \
  -H "Content-Type: application/json" \
  -d '{"custom_name": "developer.bot", "domain": "yourdomain.com"}'
GET /api/messages.php?token={TOKEN}

Fetch message summaries for a given inbox token.

cURL Example
curl -X GET "https://yourdomain.com/api/messages.php?token=YOUR_TOKEN"
GET /api/message.php?id={ID}

Get full HTML/Text content and extracted OTP code for a message.

cURL Example
curl -X GET "https://yourdomain.com/api/message.php?id=1"

Python Quickstart Script

import requests, time

BASE_URL = "https://yourdomain.com/api"

# 1. Generate temp mail
res = requests.get(f"{BASE_URL}/generate.php").json()
email, token = res['email'], res['token']
print(f"Generated: {email} (Token: {token})")

# 2. Poll for emails
print("Waiting for verification email...")
for _ in range(30):
    inbox = requests.get(f"{BASE_URL}/messages.php?token={token}").json()
    if inbox['count'] > 0:
        latest = requests.get(f"{BASE_URL}/message.php?id={inbox['messages'][0]['id']}").json()
        print(f"Subject: {latest['message']['subject']}")
        print(f"OTP Code: {latest['message']['otp_code']}")
        break
    time.sleep(2)

Live Service Analytics

REAL-TIME
📨
0
Emails Received Today
📬
0
Inboxes Created Today
⚡
0
Active Addresses
🛡️
24h
Auto-Purge Retention

Preferences & Token Management

Notifications

Sound Alerts

Play audio chime when a new email arrives

Auto-Copy Address

Automatically copy newly generated addresses to clipboard

Hostinger Email Integration (IMAP)

Test Hostinger Mailbox Connection

Verify if Hostinger IMAP credentials and email sync are working

Saved Token History

Previously generated inboxes saved in your browser: