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": "[email protected]",
    "token": "mailbox_private_token",
    "created_at": 1700000000,
    "expires_at": 1700000600
  }
}

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": "[email protected]",
    "expires_at": 1700000600
  },
  "otp": {
    "code": "654321",
    "service": "OpenAI",
    "sender": "[email protected]",
    "subject": "Your verification code",
    "received_at": 1700000100,
    "message_id": 123
  }
}