The Best Temp Mail for Developers API

Automate email verification and testing with our robust REST API.

Get API Key

All API requests must include your API key in the `Authorization` header: Bearer YOUR_API_KEY.

POST /api/client/create

Initialize a new client session to receive a UUID. This UUID is required for all subsequent requests.

Request Example (cURL)
curl -X POST https://api.tempnmail.com/client/create \ -H "Authorization: Bearer YOUR_API_KEY" \ -d "app_uuid=your_app_identifier"
POST /api/email/random

Generate a random temporary email address associated with your client UUID.

Request Example (Node.js)
const response = await fetch('https://api.tempnmail.com/email/random', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/x-www-form-urlencoded' }, body: 'uuid=YOUR_CLIENT_UUID' }); const data = await response.json(); console.log(data.email.alias + '@' + data.email.domain_name);
POST /api/messages

Fetch all new messages for a specific email address.

Request Example (cURL)
curl -X POST https://api.tempnmail.com/messages \ -H "Authorization: Bearer YOUR_API_KEY" \ -d "uuid=YOUR_CLIENT_UUID" \ -d "selected_email_id=EMAIL_ID" \ -d "known_message_id=0"

Need higher limits or a custom integration?

We offer enterprise SLA, dedicated IP addresses, and custom catch-all domains for high-volume automated testing.

Contact Sales