Accounts
Manage temporary email accounts.
Manage your temporary email accounts with these endpoints.
➕ Create Account
POST /api/v1/temp-mail/accounts
Creates a new temporary email account. Supports two providers: Mail.tm (default) and MoeMail.
Request Body (optional):
{
"provider": "mail.tm", // or "moemail" (default: "mail.tm")
"address": "[email protected]", // optional, auto-generated if omitted
"password": "mypassword", // optional, auto-generated if omitted (not used for MoeMail)
"domain": "zenra.my.id" // optional, only for MoeMail provider (e.g., "zenra.my.id", "kineta.my.id")
}Response 201 (Mail.tm):
{
"success": true,
"provider": "mail.tm",
"account": {
"id": "...",
"address": "[email protected]",
"password": "mypassword",
"token": "eyJhbGciOi...",
"createdAt": "2026-03-28T12:00:00.000Z"
}
}Response 201 (MoeMail):
{
"success": true,
"provider": "moemail",
"account": {
"id": "...",
"address": "[email protected]",
"createdAt": "2026-03-28T12:00:00.000Z"
}
}Provider Comparison:
| Feature | Mail.tm | MoeMail |
|---|---|---|
| Password Required | ✅ Yes | ❌ No |
| Token Authentication | ✅ Yes | ❌ No |
| Custom Address | ✅ Yes | ❌ No (auto-generated) |
| Domain | Various | Multiple (.my.id domains) |
| Domain Selection | ❌ No | ✅ Yes (zenra.my.id, kineta.my.id) |
| Message Retention | Permanent | Temporary |
MoeMail Domain Selection:
To get available domains, use the Domains endpoint. If no domain is specified, a random domain will be assigned.
Example with specific domain:
{
"provider": "moemail",
"domain": "kineta.my.id"
}List Accounts
GET /api/v1/temp-mail/accounts
Returns all temporary email accounts tied to your API Key's user account.
Response 200:
{
"accounts": [{ "id": "...", "address": "...", "createdAt": "..." }]
}🔍 Get Account Detail
GET /api/v1/temp-mail/accounts/{id}
Returns the full detail of a specific account. Mail.tm accounts include a token for inbox access; MoeMail accounts do not require a token.
Response 200:
{
"id": "...",
"address": "[email protected]",
"password": "",
"token": null,
"createdAt": "2026-03-28T12:00:00.000Z"
}Delete Account
DELETE /api/v1/temp-mail/accounts/{id}
Deletes the account from the Devora database. Mail.tm accounts are also deleted from the upstream provider when a token is available; MoeMail accounts are removed from Devora history only.