Troubleshooting Adding an Email Account on iPhone

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

Updated on: 03/28/2026