Temp Mail API: Automate Email Testing with Disposable Inboxes
Testing email flows manually is slow and error-prone. The Temp Mail Now API lets you create temporary email addresses, fetch incoming messages, and integrate disposable inboxes directly into your CI/CD pipelines and QA automation.
What the Temp Mail API lets you do
Create temporary inboxes programmatically, retrieve messages in JSON format, verify that emails are delivered and contain the correct content, run parallel email test suites without any domain setup, and load-test email sending infrastructure. Authentication uses a Bearer API key generated from your dashboard. The API is available on Plus and Pro plans.
API quickstart
# Create a temporary inbox
curl -X POST https://api.temp-mail-now.com/v1/inbox \
-H "Authorization: Bearer YOUR_API_KEY"
# Fetch messages for an address
curl "https://api.temp-mail-now.com/v1/messages?address=YOUR_ADDRESS" \
-H "Authorization: Bearer YOUR_API_KEY"See the full API documentation for all endpoints, parameters, and response formats.
Common developer use cases
- •Automated signup flow testing in CI/CD pipelines
- •Verifying that transactional emails are sent and contain correct content
- •Email regression testing on every deployment
- •Load testing email sending infrastructure at scale
- •QA automation for SaaS products with email-dependent flows
- •Testing email templates before deploying to production
- •Integration testing for email verification steps
Frequently asked questions
Does Temp Mail Now have a public API?+
Yes. Temp Mail Now provides a REST API for creating temporary inboxes and fetching messages programmatically. The API requires a Plus or Pro plan subscription and an API key generated from your dashboard.
What programming languages does the API support?+
The API is HTTP-based and works with any language that can make HTTP requests — Python, JavaScript, TypeScript, Go, Ruby, PHP, Java, and more. No special SDK is required.
What is the API rate limit?+
Plus plan: 10 requests per minute. Pro plan: 100 requests per minute. Contact support if you need higher limits for large-scale testing.
Can I use the Temp Mail API in a CI/CD pipeline?+
Yes. The API is designed for automated, headless use. Many teams integrate it with GitHub Actions, GitLab CI, Jenkins, or other CI systems to run email flow tests on every deployment.
No messages yet. Send something to this address to test.
Inboxes auto-expire after 6 hours.