Overview
mail.tm is a temporary email service API that creates persistent (but disposable) email accounts accessible via a REST interface using JWT authentication. Unlike single-session throwaway services, mail.tm accounts persist until manually deleted, making it suitable for multi-step testing workflows. It follows a JSON-LD / Hydra API convention and supports full message read, delete, and account management.
Beginner Tip
mail.tm works in three steps: check available domains (GET /domains), create an account (POST /accounts) on one of those domains, then authenticate (POST /token) to get a JWT for inbox access. Save the JWT — you need it for every inbox request.
Available Data
Example Response
{
"message_id": "msg_abc123def456",
"status": "delivered",
"to": "[email protected]",
"subject": "Welcome!",
"timestamp": "2025-01-15T10:30:00Z"
} Field Reference
@context JSON-LD context URL indicating mail.tm uses Hydra API conventions for collection responses hydra:member The actual array of resource objects (domains, messages, or accounts) in a collection response id Unique resource identifier, typically in the form /resource-type/uuid address The full temporary email address (e.g., [email protected]) for a created account token JWT bearer token returned from POST /token, required in Authorization header for inbox access intro Plain-text preview of the email message body shown in the message list Implementation Example
const url = "https://docs.mail.tm/";
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
Alternatives to mail.tm
Technical alternatives for different use cases.
Temporary email with REST API and custom domain support
Email address longevity and reliability
Disposable email with API-first design
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.