Mailboxes and mail apps
A mailbox is a real email address on your domain, like support@acme.dev, with its own inbox. Read it in the Zevuki mailbox at mailbox.zevuki.com or in any mail app.
Create a mailbox
Open Mailboxes in the dashboard, pick a verified domain, and enter the address and a password (at least 10 characters). Share the password with the person who will use the mailbox. The Free plan includes 3 mailboxes with 1 GB of storage each, Starter 5 with 5 GB, and Pro 25 with 15 GB.
The Zevuki mailbox
Sign in at mailbox.zevuki.com with the full address and its password. It works on desktop and phone. On a keyboard: J/K move between conversations, E archives, R replies, C composes, / searches and Ctrl K opens every command.
- Sent sync. When your app sends through the API from an address that has a mailbox, a copy appears in that mailbox's Sent folder. Replies then thread with the original.
- Undo send. You have a few seconds to take back an email after pressing Send.
- Swipe actions on phones: swipe a conversation to archive it.
Mail apps (IMAP and SMTP)
Use these settings in Apple Mail, Thunderbird, Outlook or your phone's mail app. The username is always the full email address.
| Server | Port | Security | |
|---|---|---|---|
| Incoming (IMAP) | imap.mail.zevuki.com | 993 | SSL/TLS |
| Outgoing (SMTP) | smtp.mail.zevuki.com | 465 | SSL/TLS |
| Outgoing (alternative) | smtp.mail.zevuki.com | 587 | STARTTLS |
SMTP with an API key
Apps and services that can only send over SMTP don't need the HTTP API. Sign in with any username and a Zevuki API key as the password:
| Setting | Value |
|---|---|
| Host | smtp.mail.zevuki.com |
| Port | 465 (TLS), or 587 (STARTTLS) |
| Username | Anything, such as zevuki |
| Password | Your API key, zv_... |
The From address must be on a verified domain of your account. Each message counts toward your monthly emails like an API email, and appears in the email log with delivery webhooks. Blocked (bounced or complained) addresses are refused. Idempotency keys and tags are only available in the HTTP API.
Reading a mailbox through the API
| Request | What it does |
|---|---|
GET /v1/mailboxes/{id}/messages | The Inbox, newest first. ?limit=20 (up to 100) and ?before=<id> for the next page; the response has has_more and next_cursor. |
GET /v1/mailboxes/{id}/messages/{message_id} | One message with its text, html and a list of attachments (name, type, size). Reading doesn't mark it as read. |
To get new mail as it arrives, use the email.received webhook instead of polling.
Mailboxes through the API
Platforms can give their own customers a mailbox, like support@theirstore.com, with a full-access key. The domain must receive mail.
| Request | What it does |
|---|---|
POST /v1/mailboxes | Create: {"address", "name", "password"}. Leave out password and Zevuki generates one, returned only in this response. |
GET /v1/mailboxes | List, optionally ?domain_id=42. |
GET /v1/mailboxes/{id} | One mailbox. |
PATCH /v1/mailboxes/{id} | Change name or password, or {"reset_password": true} to get a new generated one. |
DELETE /v1/mailboxes/{id} | Delete the mailbox and all its mail. |
POST /v1/mailboxes/{id}/addresses | Shared inbox: add {"address"}, such as hello@ next to support@, so both land in this mailbox. |
DELETE /v1/mailboxes/{id}/addresses/{address_id} | Stop delivering one shared address. Mail to it is refused from then on. |
A shared inbox is one mailbox with several addresses on your domains. Its mail, storage and login are shared: adding an address doesn't use another mailbox from your plan or any extra storage. Webmail's From list shows every address of the inbox, so you can reply as any of them. The mailbox's own address stays its login; the extra ones are listed under addresses.
{
"object": "mailbox",
"id": "17",
"address": "support@shop.example",
"name": "Support",
"domain_id": "42",
"created_at": "2026-11-14T10:00:00Z",
"password": "x7Kq...",
"webmail_url": "https://mailbox.zevuki.com/",
"imap": { "host": "imap.mail.zevuki.com", "port": "993", "security": "tls", "username": "support@shop.example" },
"smtp": { "host": "smtp.mail.zevuki.com", "port": "465", "security": "tls", "username": "support@shop.example" }
}New mail in any of your mailboxes is sent to your email.received webhooks, so your app can open a ticket or notify someone.
Receiving mail
Incoming mail needs the domain's MX record to point to mx.mail.zevuki.com. Mail to an address without a mailbox is rejected, so senders know it didn't arrive. Attachments are kept on every plan.