Disposable Email API

Self-hosted disposable email service with a clean REST API. Generate temp addresses, receive emails, and read them programmatically.

What's Included — Full Source Code:

• Node.js SMTP server
• REST API with OpenAPI docs
• Web inbox viewer
• DNS configuration guide
• Docker deployment

Core Features:

• Generate addresses — create random or custom @yourdomain.com addresses on the fly
• Receive emails — SMTP server captures all incoming mail
• Read via API — GET /inbox/{address} returns all received emails with HTML/text body
• Auto-expiry — emails auto-delete after configurable TTL
• Multiple domains — configure as many domains as you want
• Webhook forwarding — forward received emails to your webhook URL
• Regex matching — extract verification codes, links, and tokens automatically

API Endpoints:

• POST /address — create a new disposable address
• GET /inbox/{address} — list all received emails
• GET /email/{id} — get full email content (HTML + text + attachments)
• DELETE /address/{address} — delete address and all emails
• POST /webhook — set up email-to-webhook forwarding

Use Cases:

• Automated account signups (extract verification links)
• Email testing for your own applications
• Spam honeypots
• Disposable registrations
• QA testing email flows

Deployment:

• Docker Compose (one command)
• DNS: add MX record pointing to your server
• Supports Let's Encrypt SSL
• SQLite or PostgreSQL storage

Process 10,000+ emails per hour. No external dependencies.