Question 1

How do I create a mailbox?

Accepted Answer

Once your email is verified, create a hosted mailbox on a Sairaph domain (sairaph.email, sai.email, or sent.ac) from the dashboard or the API - it is active immediately, no domain to provision first. If you want a custom address, connect or order your own domain, wait for it to provision, then create the mailbox on that domain instead. You can also connect an existing external mailbox (Gmail, Google Workspace, or Yahoo) with an app password you generate at your provider, rather than hosting one; see the Getting started FAQ.

Question 2

How many mailboxes can I have?

Accepted Answer

Your hosted-mailbox limit is set by your plan and rises on the higher tiers; the exact per-tier count and the per-mailbox storage quota are on the pricing page (mail.sairaph.com/pricing). Upgrading your plan raises the limit. Starter includes a single hosted mailbox; you can also connect a small number of external mailboxes on any plan, using an app password from your provider. See the Plans & limits FAQ.

Question 3

How is inbound mail synced?

Accepted Answer

Incoming mail on a hosted mailbox is synced over IMAP. A long-lived IDLE watcher reacts to new mail in near real time, and a periodic poll (about once a minute) is the fallback if the live connection drops, so messages arrive without you polling manually. The hosted store is authoritative; what we keep is a cache for fast reads.

Question 4

How long are messages kept?

Accepted Answer

Message envelopes (sender, subject, date, snippet, message-id) are kept indefinitely so search keeps working. Full message bodies are cached for faster reads and then evicted on a per-tier schedule. The maximum retention you can set per mailbox is capped by your plan, with the ceiling rising on the higher tiers; the exact per-tier limit is on the pricing page (mail.sairaph.com/pricing). New mailboxes start at the default retention, clamped down to your plan's cap where that is lower. Evicting a cached body does not delete the message; a request for an evicted body falls back to a live IMAP fetch, which is slightly slower.

Question 5

Are my mailbox credentials stored securely?

Accepted Answer

Yes. The SMTP/IMAP passwords behind each hosted mailbox are encrypted at rest with a per-customer Fernet key and are never returned by any API response or written to logs. Your agent authenticates to Sairaph Mail with a mailbox API key, not with the underlying mailbox password.

Question 6

Can I read a message body on demand?

Accepted Answer

Yes. Message bodies are served from cache by default; you can also request a live fetch with ?live=true (useful for agents waiting on an OTP). Live fetches are rate-limited per mailbox to protect the upstream IMAP service, and if the store is unreachable a live request falls back to cached data rather than failing.

Question 7

What is the maximum message / attachment size?

Accepted Answer

A single fetched message (envelope plus body) is capped at 25 MiB; mail larger than that cannot be retrieved in full. For sending, a message may carry up to 10 attachments, and the combined size (body plus attachments) must be 25 MiB or less.

Mailboxes

Give your agent a real mailbox