Temp mail API
A temp mail API that reads OTPs for you
Create disposable inboxes and read verification emails from your own code — for test suites, QA flows and signup automation on accounts you own.
What you can build
- End-to-end tests that sign up, wait for the verification email and read the code.
- QA tooling that needs a fresh, isolated inbox for every run.
- Internal tools that receive one-time codes for accounts your team owns.
Four email services
Each service is priced and switched on separately, so you only pay for the type you use. Call GET /services to see which are available right now.
Gmail.com + Alias
A plus-alias on a Gmail address. Fast and low-cost.
Outlook.com + Alias
A plus-alias on an Outlook address.
Gmail.com Original
A dedicated original Gmail address.
Outlook.com Original
A dedicated original Outlook address.
Endpoints
Base URL: https://freegmail.com/api/public/v1. Send your key as Authorization: Bearer YOUR_API_KEY.
- GET/servicesList the four email services, their availability and credit price.
- POST/inboxesCreate an inbox for a chosen service and get its address back.
- GET/inboxes/{id}/messagesRead messages that arrived in that inbox.
- GET/messages/{id}Read a single message in full.
- GET/account/balanceCheck your remaining credits.
- GET/account/usageSee your recent API calls and charges.
Pricing and billing
The API uses a prepaid credit wallet, topped up with USDT (BEP20) and verified automatically on-chain. Credits are only charged for successful calls; failed calls are refunded. API keys unlock after your first verified deposit, and you can hold up to three active keys. Current rates and deposit bonuses are on the Developer API page.
Acceptable use
Use the API only for inboxes and accounts you own or are authorised to test. Spam, abuse and getting around other services' rules are not allowed — see our terms.