- Home
- Disposable Email Services
- Temp Mail API
Temp Mail API
What it 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. Requests use 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 last up to 30 days, after which emails are automatically deleted. Monthly request quotas vary by subscription plan; 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, alongside client libraries for Golang, .NET, Node.js, PHP, and Python. A remote MCP server connects the API with AI coding clients and also requires premium access. The API page says requests use HTTPS and temporary email content is permanently deleted without backups after the retention period. There is no free trial; a refund is offered within 30 days if the customer is not satisfied.
For and against
For
- Creates, retrieves, and deletes email messages programmatically
- Supports attachment downloads and message source reading
- Client libraries listed for five languages
- Listed integrations include Playwright and GitHub Actions
Against
- API access requires an active premium account
- No free trial
- Addresses last up to 30 days
The verdict
Temp Mail API combines temporary inbox management with message retrieval and deletion tools. Check the premium-access requirement and retention period against your workflow before choosing it.
Who it suits
It suits developers who need temporary inboxes for programmatic email retrieval, testing, or CI/CD workflows. AI coding client integrations and client libraries are also listed for teams using those tools.
Plans and prices
Premium
1,000 API requests/mo · premium domains · 10 custom domains · saved messages
Read 29 Sep 2026 · temp-mail.io
On the record
- 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 · read 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.temp-mail.io · read 29 Sep 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 · read 29 Sep 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 · read 29 Sep 2026
- Free access
- The maker describes its temporary email service as free, while API access is a premium feature.temp-mail.io · read 29 Sep 2026
- Integrations
- The maker lists email testing and CI/CD use cases, naming Playwright, GitHub Actions, Jenkins, and GitLab CI.temp-mail.io · read 29 Sep 2026
- Libraries
- Officially supported client libraries are listed for Golang, .NET, Node.js, PHP, and Python.docs.temp-mail.io · read 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.temp-mail.io · read 29 Sep 2026
- Purpose
- The API creates and manages temporary email addresses and lets users retrieve incoming messages programmatically.docs.temp-mail.io · read 29 Sep 2026
- Retention
- API email addresses last up to 30 days, after which the emails are automatically deleted.temp-mail.io · read 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.temp-mail.io · read 29 Sep 2026
- Support
- The maker directs users with questions or suggestions to [email protected].temp-mail.io · read 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.temp-mail.io · read 29 Sep 2026
