Developer API
The disposable email API for developers
Spin up temporary inboxes and read incoming mail - verification codes, OTPs, signup emails - with a simple REST API. Start free, scale when you need to.
Getting started
Choose one of two ways to use the API.
RapidAPI
Subscribe on the RapidAPI marketplace — your key, billing, and usage are all handled by RapidAPI. Best if you already use it.
API docs & instructions on RapidAPIDirect API key
Create an API key in your dashboard and pay via Stripe. Manage keys, plan, and usage all in one place.
Get your API keyQuickstart
# 1. Create an inbox
curl -X POST https://api.tempmailer.io/v1/inboxes \
-H "X-API-Key: tmk_live_your_key" \
-H "Content-Type: application/json" -d '{}'
# 2. Poll for messages (verification codes, OTPs, ...)
curl https://api.tempmailer.io/v1/inboxes/INBOX_ID/messages \
-H "X-API-Key: tmk_live_your_key"That's the whole flow - create an inbox, then read its messages. Prefer push over polling? Register a webhook and we'll deliver each message as it arrives. See the full API reference.
Everything you need to automate email
Instant inboxes
Create a disposable inbox and start receiving mail in one request. Random or custom addresses.
Auto-OTP
On Ultra+, verification codes are parsed out of incoming mail and returned as a ready-to-use field.
Webhooks
Skip polling. Get an HMAC-signed push the moment a message lands, with automatic retries.
Plan-based retention
Messages and inboxes auto-expire on a schedule that scales with your plan, 24h up to 30 days.
Isolated & reliable
Runs on dedicated domains and infrastructure, fully separate from the consumer service.
OpenAPI + RapidAPI
A machine-readable spec you can import anywhere, plus one-click onboarding on RapidAPI.
Simple, scalable pricing
Same plans whether you buy on RapidAPI or directly.
Free
- 1,000 requests / mo
- 1 req/sec
- 24h retention
- Random & custom inboxes
- Read messages
- REST API + OpenAPI
Pro
- 20,000 requests / mo
- 10 req/sec
- 7-day retention
- Everything in Free
- Outbound webhooks
- Priority delivery
Ultra
- 150,000 requests / mo
- 25 req/sec
- 30-day retention
- Everything in Pro
- Auto-OTP extraction
- Higher rate limits
Mega
- 500,000 requests / mo
- 50 req/sec
- 30-day retention
- Everything in Ultra
- Metered overage
- Best throughput
API domains
Inboxes are created on these dedicated domains.
Reserved names
These usernames are blocked for custom inboxes.
Role names like admin, support, and no-reply are reserved.
Frequently asked questions
Two ways: subscribe on RapidAPI (authentication handled for you), or use a direct API key from your dashboard, passed as the X-API-Key header.
API inboxes use a dedicated set of domains, separate from the consumer site, so your traffic never mixes with normal temp-mail users.
Yes, on paid plans. Register an endpoint and we deliver an HMAC-signed message.received event with automatic retries, so you never have to poll.
On RapidAPI, they bill you by tier. Direct customers are billed via Stripe and manage everything (plan, invoices, cancel) from the dashboard.
Free and mid plans return a clear quota_exceeded error so you can upgrade; the top plan meters overage instead of hard-blocking.
Start building in minutes
Free tier, no credit card. Upgrade when you scale.
By using the API you agree to the API Terms & Acceptable Use.