Temp Mail API
Temp Mail API creates temporary email addresses and provides programmatic access to incoming messages.
What Temp Mail API is
Temp Mail API creates temporary email addresses and provides programmatic access to incoming messages. It can list and retrieve 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 as free, but API access is a premium feature. Addresses can remain active for up to 30 days, after which associated emails are automatically deleted. Monthly API request limits depend on the subscription plan; the subscription page lists 1,000 requests per month. Supported client libraries include Golang, .NET, Node.js, PHP and Python. The service lists email testing and CI/CD integrations such as Playwright, GitHub Actions, Jenkins and GitLab CI. Its remote MCP server connects the API to AI coding clients and also requires premium access. The service says requests use HTTPS and temporary data is permanently deleted after its retention period, without backups. There is no free trial; the subscription page offers a refund within 30 days if a customer is dissatisfied.
Good
- Can retrieve messages and download attachments
- Supported libraries include five programming languages
- Integrations include Playwright and GitHub Actions
- Email data is deleted after retention
- Temporary email service is described as free
Watch out
- API access requires an active premium account
- No free trial is offered
- Addresses last up to 30 days
- Monthly request quotas vary by plan
Who it suits
It suits developers who need temporary inboxes for programmatic email testing or CI/CD workflows. API users should be prepared to use an active premium account.
Verdict
Temp Mail API offers message retrieval and management for temporary addresses, with libraries and integrations aimed at development workflows. The temporary email service is described as free, but using the API requires premium access.
Plans and prices
From Temp Mail API's own pricing page, checked 29 Sep 2026.
| Plan | Price | What it gives you |
|---|---|---|
| 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 |
The facts
Each one read from Temp Mail API's own pages, with the date it was checked.
What it does
- 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.checked 29 Sep 2026
- API limits
- Monthly API request quotas depend on the subscription plan; the subscription page lists 1,000 API requests per month included.checked 29 Sep 2026
- Authentication
- API requests require an API key in the X-API-Key header, and API access requires an active premium account.checked 29 Sep 2026
- Email handling
- The API supports creating addresses, listing and retrieving messages, downloading attachments, reading message source, and deleting emails or messages.checked 29 Sep 2026
- Integrations
- The maker lists email testing and CI/CD use cases, naming Playwright, GitHub Actions, Jenkins, and GitLab CI.checked 29 Sep 2026
- Libraries
- Officially supported client libraries are listed for Golang, .NET, Node.js, PHP, and Python.checked 29 Sep 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.checked 29 Sep 2026
- Purpose
- The API creates and manages temporary email addresses and lets users retrieve incoming messages programmatically.checked 29 Sep 2026
- Retention
- API email addresses last up to 30 days, after which the emails are automatically deleted.checked 29 Sep 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.checked 29 Sep 2026
- Support
- The maker directs users with questions or suggestions to [email protected].checked 29 Sep 2026
Money
- Free access
- The maker describes its temporary email service as free, while API access is a premium feature.checked 29 Sep 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.checked 29 Sep 2026
Alternatives to Temp Mail API
- 1
EmailOnDeck
Free planAndroidiOSWebAPI8.1Free plan - 2
Guerrilla Mail
Free planOpen sourceAndroidWebAPIExtension8.1From $9.99 a year - 3
Mailinator
Free planAndroidWebAPIExtension7.8From $79 a month - 4
SecureTempMail
Free planWebAPIExtensionLinux7.8From $39 a year - 5
Mohmal
Free planWeb7.5From $35.99 a year - 6
MailDrop
Free planWebAPI7.4From $5 a month