Temp Mail API

Free plan AndroidAPIExtensioniPhoneWeb

Visit Temp Mail API Alternatives Pricing

What Temp Mail API is

Temp Mail API creates temporary email addresses and lets software retrieve incoming messages programmatically. Its email tools can list and fetch messages, download attachments, read message source, and delete emails or individual messages. API requests require an API key in the X-API-Key header, and API access requires an active premium account; the maker describes its temporary email service itself as free. Addresses can last up to 30 days, after which emails are automatically deleted. Monthly request quotas depend on the subscription plan, and the subscription page lists 1,000 API requests per month. The maker lists email testing and CI/CD uses with Playwright, GitHub Actions, Jenkins and GitLab CI. Supported client libraries include Golang, .NET, Node.js, PHP and Python. A remote MCP server connects the API to AI coding clients and also requires premium access. The service says requests use HTTPS and temporary email data is permanently deleted without backups after the retention period. There is no free trial; the subscription page offers a refund within 30 days if a customer is not satisfied.

Who it suits

It suits developers automating temporary inboxes for email testing or CI/CD workflows, particularly those using one of the listed client libraries or integrations. API and remote MCP access require an active premium account.

What it does well

Can retrieve messages and download attachments programmatically.
Lists libraries for Golang, .NET, Node.js, PHP and Python.
Integrations include Playwright, GitHub Actions, Jenkins and GitLab CI.
Emails are automatically deleted after retention, up to 30 days.

What to know first

API access requires an active premium account.
No free trial is offered.
API requests require an API key in the X-API-Key header.

Limits

The subscription page lists 1,000 API requests per month, with quotas depending on the plan. Temporary addresses last up to 30 days, after which associated emails are automatically deleted.

Plans

Plan	Billed and limits	Price
Premium	1,000 API requests/mo · premium domains · 10 custom domains · saved messages · unlimited forwarding · 10 emails at once · no ads · inbox in extensions · 30 days of message storage · 500 records in history · cloud history sync	On request

As docs.temp-mail.io lists them, read 29 Sept 2026. The maker's own page has the final word.

Getting started

Open the Temp Mail API documentation website
Choose a supported client library or make HTTPS API requests
Activate a premium account for API access
Provide the API key in the X-API-Key header
Create a temporary email address
List or retrieve messages and attachments programmatically

Verdict

Temp Mail API supports programmatic handling of temporary inboxes and lists several testing and CI/CD integrations. The maker describes the email service as free, but API access and its remote MCP server require an active premium account.

Questions

Is the temporary email service free?

The maker describes its temporary email service as free. API access is a premium feature requiring an active premium account.

Is there a free trial?

No free trial is offered. The subscription page provides a refund within 30 days if a customer is not satisfied.

What platforms are supported?

Temp Mail API lists Android, iOS, web, browser extensions, and an API.

How do API requests authenticate?

Requests require an API key sent in the X-API-Key header, and API access requires premium activation.

Which programming languages have official libraries?

Officially supported libraries are listed for Golang, .NET, Node.js, PHP, and Python.

How long do inboxes and messages remain?

Temporary addresses can last up to 30 days. After that period, emails are automatically deleted, and the service says temporary data is permanently removed without backups.

Facts from Temp Mail API's own pages

AI integrations: The remote MCP server connects the API to AI coding clients including Claude Code, Cursor, VS Code Copilot, Codex, and others, and requires an active premium account. · docs.temp-mail.io, 29 Sept 2026
API limits: Monthly API request quotas depend on the subscription plan; the subscription page lists 1,000 API requests per month included. · temp-mail.io, 29 Sept 2026
Authentication: API requests require an API key in the X-API-Key header, and API access requires an active premium account. · docs.temp-mail.io, 29 Sept 2026
Email handling: The API supports creating addresses, listing and retrieving messages, downloading attachments, reading message source, and deleting emails or messages. · docs.temp-mail.io, 29 Sept 2026
Free access: The maker describes its temporary email service as free, while API access is a premium feature. · temp-mail.io, 29 Sept 2026
Integrations: The maker lists email testing and CI/CD use cases, naming Playwright, GitHub Actions, Jenkins, and GitLab CI. · temp-mail.io, 29 Sept 2026
Libraries: Officially supported client libraries are listed for Golang, .NET, Node.js, PHP, and Python. · docs.temp-mail.io, 29 Sept 2026
Privacy policy: The privacy policy says temp-mail.io does not store IP addresses and permanently deletes emails and temporarily stored data after their retention period. · temp-mail.io, 29 Sept 2026
Purpose: The API creates and manages temporary email addresses and lets users retrieve incoming messages programmatically. · docs.temp-mail.io, 29 Sept 2026
Retention: API email addresses last up to 30 days, after which the emails are automatically deleted. · temp-mail.io, 29 Sept 2026
Security: The API page says requests use HTTPS encryption and email content is stored temporarily, then permanently deleted without backups after its retention period. · temp-mail.io, 29 Sept 2026
Support: The maker directs users with questions or suggestions to [email protected]. · temp-mail.io, 29 Sept 2026
Trial and refund: The subscription page says there is no free trial and offers a refund within 30 days if the customer is not satisfied. · temp-mail.io, 29 Sept 2026