API Documentation
Endpoints
/api/generateGenerate a new temporary email address.
Optional query: ?expiry=3600000 (ms, min 10m, max 7d, default 24h)
cURL example:
Response:
/api/generate/customCreate a custom address with your own prefix and domain.
Optional body field: "expiry": 3600000 (ms)
cURL example:
Response:
/api/domainsList all active domains.
cURL example:
Response:
/api/inbox/{address}Get all emails in an inbox. Returns non-expired emails for the session.
Send the token from the generate response in the X-Inbox-Token header. Do not place inbox tokens in URLs or logs.
cURL example:
Response:
/api/email/{id}?address={address}Get full email content including HTML body, plain text, and attachments.
cURL example:
Response:
/api/attachment/{id}?address={address}Download an attachment file.
cURL example:
Response:
/api/inbox/{address}Delete all emails in an inbox.
cURL example:
Response:
/api/inbox/{address}/extendExtend inbox expiry by 24 hours.
cURL example:
Response:
/api/inbox/{address}/forwardPro / Business onlySet email forwarding to a real address. (Premium)
cURL example:
Request body:
Response:
/api/inbox/{address}/forwardPro / Business onlyRemove email forwarding.
cURL example:
Response:
WebSocket — Real-time Updates
For real-time inbox notifications, see the dedicated WebSocket section in the sidebar.