Documentation API - XMinuteMail

Base URL: https://api.xminutemail.net/v1

Authentication: send your secret key in the Authorization header as a Bearer token.

Authorization: Bearer xmm_sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoints

MethodPathDescription
POST/inboxesCreate a temporary inbox
GET/inboxes/:idRetrieve an inbox and its TTL
GET/inboxes/:id/messagesList received messages
GET/messages/:idRetrieve a full message (headers, html, text)
DELETE/inboxes/:idDelete an inbox immediately
POST/webhooksRegister a webhook for incoming messages

Create an inbox

curl -X POST https://api.xminutemail.net/v1/inboxes \
  -H "Authorization: Bearer $XMM_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"ttl":"30m","domain":"premium"}'

Response

{
  "id": "ibx_01HABCD...",
  "address": "[email protected]",
  "expires_at": "2026-05-31T15:30:00Z",
  "ttl_seconds": 1800
}

Rate limits

PlanInboxes / hourMessages / minuteWebhooks
Sandbox (test)601203
Developer5 0001 00025
EnterpriseCustomCustomUnlimited

SDKs

Official SDKs available for Node.js, Python, Go and PHP. See examples on GitHub.