Complete documentation for Mailoverse. Learn how to use disposable email addresses for automated testing, integrate with Playwright, Cypress, Vitest, and retrieve emails via our REST API.
Introduction
Mailoverse is a developer-focused service that provides disposable email addresses for automated testing. Instead of mocking email delivery or manually checking inboxes, you can send real emails to Mailoverse and retrieve them programmatically via our API.
Use Cases
- End-to-End Testing — Test signup flows, password resets, email verification, and other email-dependent features with Playwright, Cypress, or Selenium.
- CI/CD Pipelines — Validate that your application sends the correct emails as part of your automated test suite.
- Development — Quickly test email templates and content without sending to real addresses or checking spam folders.
- QA Testing — Verify email content, links, and images are correct before release.
How It Works
Mailoverse works in three simple steps:
Create an Account
Sign up for free and get your unique subdomain and API key from the dashboard.
Send Emails
Configure your app to send emails to any address at your subdomain,
e.g., user@abc123.mailoverse.com.
Retrieve via API
Use the API to fetch emails, with links and images automatically extracted for easy assertions.
Quick Example
Retrieve the latest email sent to a specific address:
curl -X GET 'https://api.mailoverse.com/email?address=test@yoursubdomain.mailoverse.com' \
-H 'Authorization: Bearer your-api-key'The response includes parsed links and images, making it easy to verify email content:
{
"email": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"from": ["noreply@yourapp.com"],
"to": ["test@yoursubdomain.mailoverse.com"],
"subject": "Verify your email",
"parsedHtml": {
"links": [
{ "href": "https://yourapp.com/verify?token=abc123", "text": "Verify Email" }
],
"images": ["https://yourapp.com/logo.png"]
},
"receivedAt": "2025-12-31T10:30:00.000Z"
}
}