Help menu Add & manage accounts

Add one email account

Fill in the single-account form, test the sign-in, and add it.

Works in: Windows app3 minUpdated 2026-11-03

Add one email account with its sign-in details. For many accounts, add a list instead.

Fill in the form 2 min#

  1. In Accounts, select Add accounts, then select One account.
  2. Enter the address in Email. Mailman detects the provider. Open Provider to change it.
  3. Enter the password in Password. Gmail, Yahoo, AOL and iCloud show App password, which you create in the provider's security settings.
  4. For a provider Mailman doesn't know, enter IMAP host and IMAP port.
  5. Select Test sign-in.
  6. Select Add account, or Add & next to clear the form for another account. It keeps the provider, proxy and group.

Mailman syncs the new account right away when Start syncing once it is added is on, even if automatic sync is off. It is on by default.

Optional details#

FieldWhat it's for
Proxy (optional)A proxy for this account only: host:port:user:pass or a full URL
Recovery email (optional)Where Microsoft sends verification codes during browser sign-in
Aliases (optional, one per line)Other addresses that deliver to this mailbox
2FA secret (optional, base32)The account's authenticator secret, so Mailman can show its current 2FA code
GroupThe group to put the account in

Microsoft and token sign-in#

For Outlook, Hotmail and Microsoft 365, select Sign in with Microsoft. Your browser opens, you approve once, and Mailman saves the account without a password. For a work or school address, pick Microsoft 365 (work or school) in Provider. Mailman may detect it and say "Detected a Microsoft 365 work or school account". More in Outlook.

If you hold a refresh token instead, select OAuth token under Sign-in, then enter Refresh token and Client ID. Yahoo also takes Client secret (optional). For Microsoft, Password (optional, for browser sign-in) keeps the password for later browser sign-in.

If something went wrong#

You seeDo this
"Already in Mailman · open it"Select it to open the existing account instead of adding a duplicate
"Password required" or "Refresh token required"Fill in that field. The checks beside the form turn to "✓"
"Proxy format needs attention"Use host:port, host:port:user:pass, user:pass@host:port or a URL
Bad credsThe provider rejected the details. See An account won't sync
Not checked yetNot checked since it was added or its connection details changed. Open Sync and select Sync everything now

What's next