Help
Fix email errors
Every message Glassmail shows when an account won't connect, sync or send, and what to do about it.
Glassmail connects your Mac straight to your email provider, so most errors come from the provider. Find the message you saw below. If it isn't here, write to hi@glassmail.app with the exact words and a person replies, usually within a day. Never send a password.
Outlook.com, Hotmail and Microsoft 365
“Microsoft didn’t open this mailbox”
Microsoft signed you in but refused access to the mail.
- Check you can read your mail at outlook.live.com. If Microsoft asks you to verify your account or solve a puzzle there, do it.
- Open account.live.com/consent/Manage, choose Glassmail › Edit, and remove it.
- In Glassmail, add the account again and accept the permissions Microsoft shows.
“Turn on IMAP at Outlook.com”
Shown for accounts that Glassmail reads over IMAP. Outlook.com keeps IMAP off for new accounts.
- At outlook.live.com, open Settings › Mail › Forwarding and IMAP.
- Turn on Let devices and apps use IMAP and click Save.
- Wait a few minutes, then click Try again.
If it says “User is authenticated but not connected” even with IMAP on, that’s a known Microsoft problem with some personal accounts. Remove the account in Glassmail and add it again: Outlook.com, Hotmail, Live and MSN addresses now connect through Microsoft Graph, which isn’t affected.
“Microsoft signed this account out”
Your password changed, you removed Glassmail’s access, or Microsoft ended the sign-in. Open Glassmail › Settings › Accounts, choose the account and click Sign In Again…
Work or school account won’t connect
- “Need admin approval” on Microsoft’s page: your organisation lets only approved apps in. Send glassmail.app/it to your IT team: it explains what Glassmail asks for and has a one-click approval link for them.
- “Microsoft didn’t let Glassmail read this mailbox”: IMAP is off for your mailbox. An administrator can turn it on in the Microsoft 365 admin centre (Users › Mail › Manage email apps).
“Reading works, sending doesn’t yet”
For work and school accounts, Microsoft 365 often turns off Authenticated SMTP, which mail apps use to send. An administrator has to turn it on for your mailbox (Users › Mail › Manage email apps › Authenticated SMTP).
“This message is too large to send from an Outlook.com account”
Outlook.com and Hotmail accounts can send messages up to about 3 MB from Glassmail, attachments included. Share bigger files as a link, for example from iCloud Drive or OneDrive.
Gmail and Google Workspace
“Google didn’t accept that password”
- Use an app password, not your Google password. Make one at myaccount.google.com/apppasswords.
- Paste all 16 letters. The spaces don’t matter.
- If you deleted that app password in your Google account, make a new one and enter it in Settings › Accounts › Update Password…
The app passwords page says it’s not available
- 2-Step Verification is off. Turn it on at myaccount.google.com, then open the app passwords page again.
- A work or school account: your administrator has turned app passwords off. Ask them to allow app passwords for mail apps.
- Advanced Protection doesn’t allow app passwords.
Gmail connects but mail doesn’t load
On some older accounts IMAP is off. In Gmail on the web, open Settings › See all settings › Forwarding and POP/IMAP, enable IMAP and save.
iCloud Mail
“Apple didn’t accept that password”
- Make an app-specific password at account.apple.com › Sign-In and Security › App-Specific Passwords. Your Apple Account password won’t work in mail apps.
- Paste it into Glassmail exactly as shown.
App-specific passwords need two-factor authentication on your Apple Account, which most accounts already have.
Yahoo and AOL
“Yahoo didn’t accept that password”
Make an app password in your Yahoo or AOL Account Security page (“Generate app password”), and use your full address as the username. Your normal password won’t work in mail apps.
Other providers and custom domains
“Couldn’t reach <server>”
- Check your internet connection. A VPN, firewall or captive Wi-Fi page (hotels, airports) can block mail.
- If you typed the server name, check it against your mail host’s help page. Incoming mail usually uses port 993, outgoing 465 or 587.
- If a sign-in started and didn’t finish, Glassmail says so and shows the server’s reply. Try again in a minute.
“The server didn’t accept that password”
- Some hosts use only the part before the @ as the username. Open Label and server settings and try that.
- Proton Mail needs Proton Mail Bridge running, and its Bridge password.
- Zoho Mail: turn on IMAP access in Zoho’s mail settings first. Zoho’s free plan may not include it.
- Fastmail: make an app password with mail access.
Mail stops arriving
“<Account> isn’t getting new mail”
Glassmail couldn’t check the account for a while. The warning shows in the menu bar and in the sidebar, with the reason.
- Click Try Again. Most of the time it was a dropped connection after the Mac slept.
- If it says the password was rejected or you were signed out, update the password or sign in again in Settings › Accounts.
- If it keeps happening, check you can read the mail on the provider’s website.
Mail that won’t send
A message that couldn’t be sent stays under Not sent in the sidebar with the reason, so nothing is lost. Common replies from mail servers:
- 550 5.1.1: the address doesn’t exist. Check for a typo.
- 550 5.7.1 or 554 5.7.1: the receiving server refused it, often as suspected spam. Read the rest of the reply for the reason.
- 552: the recipient’s mailbox is full, or the message is too big for them.
- 421: the server is busy. Glassmail tries again on its own.
- 535: your password was rejected when sending. Update it in Settings › Accounts.
Still stuck?
The setup guides walk through adding each provider. Or write to hi@glassmail.app with the exact message you saw.