Troubleshooting Adding an Email Account on iPhone
Problem
You're having trouble adding your email account to Airmail on iPhone. The account fails to connect, gives an authentication error, or doesn't complete the setup.
Solution
For Gmail Accounts
- Open Airmail on your iPhone
- Go to Settings → Accounts → Add Account
- Select Gmail
- You'll be redirected to Google's sign-in page
- Enter your credentials and allow Airmail access
- If you have 2-Factor Authentication enabled, complete the verification
For Outlook / Microsoft 365
- Select Outlook or Exchange in the account type
- Enter your email and password
- If your organization uses Modern Authentication (OAuth), you may be redirected to a Microsoft login page
- If it fails, try selecting Exchange instead of Outlook and enter the server settings manually
For IMAP Accounts
- Select Other (IMAP)
- Enter your email address and password
- Airmail will attempt to auto-detect settings
- If auto-detection fails, enter the server settings manually:
- IMAP Server, Port (usually 993), SSL enabled
- SMTP Server, Port (usually 587), SSL/TLS enabled
Common Fixes
- App-specific password: If you use 2FA with iCloud, Yahoo, or AOL, you need to generate an app-specific password from your email provider's security settings
- Allow less secure apps: Some providers require this setting (check your provider's documentation)
- Check internet connection: Make sure you're connected to Wi-Fi or cellular data
- Update Airmail: Make sure you have the latest version from the App Store
- Restart iPhone: A simple restart can resolve connection issues
Updated on: 03/28/2026
Thank you!