Select a message to read it.
Your inbox is ready
Create an address, then incoming messages will appear here automatically.
API TOOLS
Mail and OTP API
Create a random or custom mailbox, then read its latest OTP securely with the mailbox token.
1
Create mailbox
Choose a random address or your own email name.
Created address
Access token
2
Get latest OTP
Use the address and private token returned when the mailbox was created.
Latest OTP
---
API REFERENCE
Quick integration
Follow these steps in order to create a mailbox and read its latest OTP.
Base URL
1
Create an API key
Open Account, create a key, and enable mailbox:create plus otp:read. The full key is shown once.
2
Add authentication
Send your API key in every server request. X-API-Key is the recommended header.
X-API-Key: sk_sup_your_api_key
Alternative: Authorization: Bearer sk_sup_your_api_key
3APOSTGET
/api/v1/mailboxes/randomCreate a random mailbox. Save mailbox.address for the OTP request.
curl -X POST "https://supemail.com/api/v1/mailboxes/random" \
-H "Content-Type: application/json" \
-H "X-API-Key: sk_sup_your_api_key" \
-d '{"domain":"otp.supemail.com"}'{
"ok": true,
"mailbox": {
"address": "quietlink950@otp.supemail.com",
"token": "mailbox_private_token",
"created_at": 1700000000,
"expires_at": 1700000600
}
}Direct URL (GET)
Open this URL directly to create a random mailbox.
https://supemail.com/api/v1/mailboxes/random?apikey=sk_sup_your_api_key&domain=otp.supemail.com3BPOSTGET
/api/v1/mailboxes/customCreate your own address. local_part must contain 3-32 lowercase letters, numbers, dots, dashes, or underscores.
curl -X POST "https://supemail.com/api/v1/mailboxes/custom" \
-H "Content-Type: application/json" \
-H "X-API-Key: sk_sup_your_api_key" \
-d '{"local_part":"your-name","domain":"otp.supemail.com"}'Direct URL (GET)
Open this URL directly to create your own address.
https://supemail.com/api/v1/mailboxes/custom?apikey=sk_sup_your_api_key&local_part=your-name&domain=otp.supemail.com4GET
/api/v1/mailboxes/{address}/otpReplace {address} with mailbox.address returned above. Encode @ as %40 when building the URL.
curl "https://supemail.com/api/v1/mailboxes/quietlink950%40otp.supemail.com/otp" \
-H "X-API-Key: sk_sup_your_api_key"Optional: add ?after_id=123 to ignore an OTP message your system already processed.
{
"ok": true,
"mailbox": {
"address": "quietlink950@otp.supemail.com",
"expires_at": 1700000600
},
"otp": {
"code": "654321",
"service": "OpenAI",
"sender": "noreply@example.com",
"subject": "Your verification code",
"received_at": 1700000100,
"message_id": 123
}
}Direct URL (GET)
Open this URL directly to get the latest OTP.
https://supemail.com/api/v1/mailboxes/quietlink950%40otp.supemail.com/otp?apikey=sk_sup_your_api_keyIf no supported OTP has arrived yet, the request still returns 200 with "otp": null.
ACCOUNT CENTER
SupEmail account
Sign in to own your inboxes and create scoped API keys.
SIGNED IN AS
0Active inboxes
0Active API keys
API
API keys
Full keys are encrypted at rest and remain visible only to their owners.
Each user can have one active API key. Use Rotate API key to replace it.
Your full API key is encrypted at rest and remains available below.