Introduction
VoidMail provides a simple REST API to create and manage disposable email inboxes programmatically. All API endpoints are under:
https://dvdhub.qzz.io/v1
Authentication
All API requests must include your API key in the request header. Get yours from the Dashboard → API Keys.
X-API-Key: vm_your_api_key_here
Create Inbox
POST/v1/inbox/create
Creates a new temporary inbox. Returns the address and expiry time.
| Parameter | Type | Required | Description |
| domain | string | No | dvdhub.qzz.io or moonhub.qzz.io (Premium only) |
| expiry | string | No | 10min, 1hr, 6hr, 24hr (Premium only) |
curl -X POST https://dvdhub.qzz.io/v1/inbox/create \
-H "X-API-Key: vm_your_key" \
-H "Content-Type: application/json" \
-d '{"domain": "moonhub.qzz.io", "expiry": "1hr"}'
{
"success": true,
"address": "a8f3k2d1b9@moonhub.qzz.io",
"domain": "moonhub.qzz.io",
"expires_at": "2026-04-26T16:00:00.000Z"
}
List Inboxes
GET/v1/inbox
curl https://dvdhub.qzz.io/v1/inbox \
-H "X-API-Key: vm_your_key"
{
"inboxes": [
{
"address": "a8f3k2d1b9@dvdhub.qzz.io",
"domain": "dvdhub.qzz.io",
"expires_at": "2026-04-26T15:00:00.000Z",
"created_at": "2026-04-26T14:50:00.000Z"
}
]
}
Get Emails
GET/v1/inbox/:address
curl https://dvdhub.qzz.io/v1/inbox/a8f3k2d1b9@dvdhub.qzz.io \
-H "X-API-Key: vm_your_key"
{
"address": "a8f3k2d1b9@dvdhub.qzz.io",
"expires_at": "2026-04-26T15:00:00.000Z",
"emails": [
{
"id": 1,
"from_address": "sender@gmail.com",
"subject": "Hello there!",
"body_text": "Email body here.",
"received_at": "2026-04-26T14:55:00.000Z"
}
]
}
Delete Inbox
DELETE/v1/inbox/:address
curl -X DELETE https://dvdhub.qzz.io/v1/inbox/a8f3k2d1b9@dvdhub.qzz.io \
-H "X-API-Key: vm_your_key"
Plans & Limits
| Feature | Free | Premium |
| Active Inboxes | 5 | 20 |
| API Calls / Day | 100 | Unlimited |
| Choose Domain | ✗ | ✓ |
| Custom Expiry | ✗ | ✓ |
| IMAP / SMTP | ✗ | ✓ |
Error Codes
| Code | Meaning |
| 401 | Missing or invalid API key |
| 403 | Plan limit reached or premium feature |
| 404 | Inbox not found |
| 429 | Daily API rate limit exceeded |
| 500 | Internal server error |