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

  1. Open Airmail on your iPhone
  2. Go to Settings → Accounts → Add Account
  3. Select Gmail
  4. You'll be redirected to Google's sign-in page
  5. Enter your credentials and allow Airmail access
  6. If you have 2-Factor Authentication enabled, complete the verification

For Outlook / Microsoft 365

  1. Select Outlook or Exchange in the account type
  2. Enter your email and password
  3. If your organization uses Modern Authentication (OAuth), you may be redirected to a Microsoft login page
  4. If it fails, try selecting Exchange instead of Outlook and enter the server settings manually

For IMAP Accounts

  1. Select Other (IMAP)
  2. Enter your email address and password
  3. Airmail will attempt to auto-detect settings
  4. 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

Was this article helpful?

Share your feedback

Cancel

Thank you!