Overview
mail.gw is a REST API for creating and managing temporary 10-minute email addresses with full inbox access, all without authentication for basic use. You can create a new random account, authenticate to list received messages, and read full email bodies in JSON format. It is designed for automated testing pipelines that need real inboxes with no cleanup overhead.
Beginner Tip
mail.gw uses a two-step flow: first create an account (POST /accounts) to get a temporary email address, then authenticate (POST /token) to receive a JWT, then use that JWT to check your inbox (GET /messages). Each step builds on the previous one.
Available Data
Example Response
{
"message_id": "msg_abc123def456",
"status": "delivered",
"to": "[email protected]",
"subject": "Welcome!",
"timestamp": "2025-01-15T10:30:00Z"
} Field Reference
id Unique identifier for the created account or message address The temporary email address created for this account token JWT bearer token returned by POST /token, required for all authenticated inbox requests hydra:member Array of message objects from GET /messages, each containing id, from, subject, and seen fields text Plain text body of a specific email message, returned by GET /messages/{id} createdAt Timestamp when the account or message was created Implementation Example
const url = "https://docs.mail.gw/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Fully tested on Apr 5, 2026
Technical Specifications
Related Tags
Similar APIs
View All →Disify
⭐ Beginner's PickDisify is a free, no-auth API that checks whether an email address or domain belongs to a known disposable or temporary email service.
DropMail
⭐ Beginner's PickDropMail provides a GraphQL API for creating and managing temporary email inboxes, letting you generate disposable addresses and receive real emails without registration.
EVA
EVA provides programmatic access to validate email addresses via REST API.
Guerrilla Mail
⭐ Beginner's PickGuerrilla Mail provides a REST API for creating and reading disposable temporary email addresses, useful for testing email flows without exposing real inboxes.
Kickbox
⭐ Beginner's PickKickbox provides a free, no-auth email verification endpoint that checks whether an email address is deliverable by performing syntax validation, domain MX lookup, and disposable address detection.