Search the docs

Find a page, a section, or an endpoint.

IMAP and SMTP

App passwords, hosts and ports, for the half that is not an API.

IMAP and SMTP are on every plan, free included. That is not generosity: a product people stay with because leaving is painful is a product that has stopped having to be good.

Hosts

IMAP   imap.pidgeon.ai   port 993   TLS
SMTP   smtp.pidgeon.ai   port 465   TLS

Both are implicit TLS. There is no STARTTLS port and no plaintext port, so there is no way to configure a client that connects without encryption.

App passwords

Your account has no password — sign-in is a one-time link — so a mail client gets its own credential instead. Create one per client under Settings → Mailboxes, and name it after the device you are setting up.

An app password is shown once, is scoped to a single mailbox, and can be revoked on its own. Revoking one does not sign you out anywhere else, which is what makes "I have lost that laptop" a thirty-second job.

The username is the full address.

Username   hello@yourdomain.com
Password   the app password, not your account

What syncs

Folders are derived rather than stored — Inbox, Starred, Sent, Drafts, Archive, Spam and Trash are predicates over your mail, and IMAP sees a UID projection of them. Flags written from a client come back: marking read in Apple Mail marks read here, and moving a message to Archive archives it.

What does not

Server-side rules, IMAP NOTIFY, and shared folders between accounts. If one of those is the reason you are here, it is not built and it is not scheduled.

Sending from a client

SMTP submission goes through the same guard as everything else — the same daily allowance, the same suppression list, the same abuse checks. A client cannot send as an address the app password does not own, and trying is refused rather than silently rewritten.