Your inbox is empty
Waiting for incoming emails. No need to refresh.
Need a real phone number for OTP verification?
Get one instantly →Email History
OTP Verification
Need a real phone number for OTP verification? Get one instantly from our partner.
Get phone number →Inbox
Create Your Temporary Email Address
Choose a username and domain above. Your inbox is live the moment you do — no signup, no ads, no waiting.
Live stats
Emails passing through our service
Real-time flow of temporary emails. Queued = delivered · Denied = blocked by filters.
Queued
Denied
Auth flow testing API: Programmatic Disposable Email for Developers
Integrate disposable email directly into your application. Our REST API lets you create inboxes, poll for messages, and automate email-based test flows in any language.
At a glance
API Flow
Generate -> Action -> Poll -> Verify.
Get API Access
What is the Auth flow testing API?
The ELBOB Custom Email API is a RESTful interface that allows developers to programmatically generate email addresses, check inboxes, and download message content. It replaces manual UI interaction with code, enabling fully automated email testing workflows.
Definition: REST API
Our API adheres to REST principles, using standard HTTP methods (GET, POST, DELETE) and JSON responses to provide a predictable, language-agnostic way to interact with our email infrastructure.
Why Use the API?
Manual testing is slow and prone to error. By using our API, you can scale your testing from one email to ten thousand emails per day. It creates a closed loop for your registration, password reset, and notification testing.
Automation is Key
Modern software development requires modern testing. You automate your build and your deployment—why are you still manually clicking confirmation links? Our API solves this.
Developer Benefits
- Reduce QA time by 90%
- Reliable message delivery via JSON
- Easy integration with Selenium/Cypress
- Language agnostic (JS, Python, Go, etc.)
- Secure token-based authentication
- High rate limits for Pro users
API Capabilities
- Generate Random/Custom Addresses
- Fetch Inbox Messages
- Get Message Attachments
- Delete Messages/Inboxes
- Filter by Sender/Subject
- Access Custom Domains
Pro Access
API access is a premium feature designed to ensure high quality of service and prevent abuse of our servers.
Low Latency
API endpoints are optimized for speed, returning mailbox contents in milliseconds to keep your test suites running fast.
Secure Transmission
All API traffic is encrypted via TLS 1.3. Your API keys and email data are never exposed in plain text.
API Security
We use Bearer Token authentication and IP-based rate limiting to protect your account and our infrastructure.
- Bearer Authentication
- Rate Limiting
- IP Whitelisting
- HTTPS Only
- Key Rotation
- Granular Scopes
API Use Cases
- Automated registration and email verification testing
- CI/CD pipeline email flow validation
- OTP and 2FA code extraction for automated test suites
- Load testing email delivery infrastructure
- Bulk email address generation for test data
- End-to-end (E2E) testing with Cypress/Playwright
Integration Steps
- 1Get API Key from Dashboard.
- 2Call POST /create endpoint.
- 3Trigger email in your app.
- 4Call GET /messages endpoint.
- 5Parse JSON response.
- 6Extract verification link/code.
- 7Complete verification.
- 8Call DELETE /mailbox to cleanup.
Setup
- 1Get Key
- 2Code
- 3Run
Pro API Features
- Higher Rate Limits
- Priority Queue
- Custom Domain Access
- Extended Retention
- Dedicated Support
- Search Capabilities
Programmatic Naming
Generate deterministic names (e.g., test-user-uuid) via API to easily map emails to database users.
API + Custom Domains
Use the API to create addresses on your own verified domains for seamless white-label testing.
API vs. UI
| Feature | API (Pro) | UI (Web) |
|---|---|---|
| Speed | ✓ Instant (Machine speed) | Fast (Human speed) |
| Scale | ✓ Unlimited automation | One at a time |
| Integration | ✓ Code-level | Copy-paste |
| Use Case | ✓ Testing/Dev | Manual Verification |
| Format | ✓ JSON | HTML/Visual |
Manual Testing Pain
- Slow and repetitive
- Human error
- Can't scale to load testing
- Hard to integrate with CI
The Automated Solution
- Fast execution
- Consistent results
- Infinite scale
- Native CI support
API Comparison
✓ Good features
✗ Expensive
✓ Fake SMTP
✗ Doesn't test real delivery
✓ Real email + Affordable
✗ Receive only
Best Value
For testing real email delivery at scale without breaking the bank, our API is the top choice.
Quick Start Example
Make a GET request to /api/private-mailbox?fullMailboxId=your-test-address@yourdomain.com with your API key to fetch all messages in that inbox. Full documentation is available at docs.ELBOB Custom Email.
Authorization: Bearer YOUR_API_KEY
Discord Bot Testing
Automate your Discord bot's email verification flow using our API.
Data Independence
Control your own test data without relying on Big Tech's APIs.
Telegram API
Verify Telegram sessions programmatically during your automated security sweeps.
OTP Extraction
Our API parses the email body and can return just the OTP code, saving you regex work.
Code to Code
Your code asks our code for the verification code. It's code all the way down.
Reddit Bots
Test your Reddit bots responsibly.
Discord API Uses
- Bot Registration
- Server Verification
- Automated Role Checks
- Integration Tests
Insta Automation
- Account Creation Scripts
- Recovery Flow Tests
- Ad API Tests
- Graph API integration
Telegram Uses
- Session Automation
- Bot Father Verification
- API Testing
OTP Scenarios
- Login Flows
- Transaction Signing
- Password Resets
- Step-up Auth
Parsing
- Regex Extraction
- DOM Parsing
- Header Analysis
- Link Following
Reddit Uses
- Bot Verification
- PRAW Integration
- Automated replies
- Mod tools testing
Auth flow testing API FAQ
Quick answers to common queries about this topic.
