Inbox - Mail - Accounts - Tools - OAuth2 Automatic / Manual Login (Outlook/Hotmail)

Introduction

Some providers, such as Hotmail/Outlook, require you to log in to your accounts via OAuth2. You can use automatic or manual login options to access your email credentials, view your emails, use mail scrapers, and more.

Setup & Recommendations

• To login to your Outlook/Hotmail accounts, you need to add your email credentials to Inbox. Click here to learn how to do this.
• Microsoft prompts for various forms of verification during login. Inbox can automatically handle TOTP 2FA and recovery email codes. You can add your TOTP 2FA Secret Key and recovery email to your credentials.  
• We recommend using automatic login initially. You can use manual login if some of your accounts encounter additional security measures that Inbox does not automatically handle.
• You can configure how many OAuth2 browsers run concurrently in Settings > Mail | Account Tools. 

Automatic Login

1. Navigate to the Accounts section of Inbox in Mail. When you hover over it, an icon that looks like a book with a person on it is titled Accounts.

2. Select the accounts you want to automatically login to. Then click the Tools button and select OAuth2 Automatic Login.

3. If you want emails to populate in the emails tab after your account is logged in, enable the Sync mail after login checkbox.

4. If you want to force re-login into the credentials before running the forwarding tool, enable the Force re-login credentials checkbox.

5. Select a Mail Task Template to use. The Mail Task Template is used if your accounts encounter 2FA codes that must be handled via IMAP. You can assign catchall/forwarded emails to your Mail Task Template. Click here to learn how to create a Mail Task Template.

6. Select an SMS Task Template to use. The SMS Task Template is used if your accounts encounter SMS verification pages during the login or forwarding flow. You can assign third-party SMS credentials to SMS Task Templates to automatically handle SMS codes. Click here to learn how to create an SMS Task Template.

7. Optionally, you can specify a Custom Password to use if Outlook forces you to change your password during login. Inbox will automatically handle this and replace the existing password in your Inbox credential. If you leave this field blank, Inbox will generate a random 16-character password for each account.

8. Your accounts will attempt to login. When they successfully log in, the Browser Status shows "Logged In" or "Already Logged In," and the IMAP Status shows "Good."

Manual Login

1. Navigate to the Accounts section of Inbox in Mail. When you hover over it, an icon that looks like a book with a person on it is titled Accounts.

2. Select the accounts you want to automatically login to. Then click the Tools button and select OAuth2 Manual Login.

3. The OAuth2 Manual Login Options dialog will appear. If you want emails to populate in the emails tab after your account is logged in, enable the Sync mail after login checkbox.

4. If you want to force relogin into the credentials before running the forwarding tool, enable the Force re-login credentials checkbox.

5. A browser will open, allowing you to manually input your account login details and handle any additional security questions. When they successfully log in, the Browser Status shows "Logged In" or "Already Logged In," and the IMAP Status shows "Good."