Setup

When creating a new Exchange or Graph account, once an Exchange or Graph account is detected, Thunderbird will give you options for both Exchange and Graph.

Configure your Exchange or Graph account

Again, for the best experience, we recommend Thunderbird 157 or newer.

1. Click the Thunderbird app menu ☰ > New Account > Email. The Account Hub dialog will appear.
2. Enter your name, email address, and if required, your two factor authentication code for your Exchange or Graph email account.
3. Click the Continue button. The password entry dialog will appear in your system web browser.
   Note: In the first dialog box, you do not enter your account password. You will enter your password in a separate, branded panel provided by Microsoft (not Mozilla) as part of their OAuth implementation.
   Screenshot of that panel provided by Microsoft:

   

4. Enter your password and click Sign in. The account type selection dialog will appear.

   

5. Select the Exchange or the Microsoft Graph API radio button and click Continue to use Thunderbird's built-in Exchange code.
6. Follow the prompts to finish adding your Exchange or Graph account.

Manual Exchange and Graph configuration

There are a diversity of Exchange and Graph servers which could cause auto configuration of your Exchange or Graph email account to fail. Here's a potential workaround for that situation:

1. Add a new email account: Thunderbird app menu ☰ > Add Account > Email, enter a Microsoft 365 email address (e.g. nemo@o365.thunderbird.net) and then click MANUAL CONFIGURATION on the bottom left of the Account hub.
2. Click Microsoft Exchange or Microsoft 365 and then click Set up account.
3. In the Exchange settings dialog, type one of the following URLs into the Enter the service URL field:
   • For EWS: https://outlook.office365.com/EWS/Exchange.asmx
   • For Graph: https://graph.microsoft.com/
4. Click Find settings. For EWS, Exchange Web Services will automatically be selected. For Graph, Microsoft Graph will be selected.
5. Your Microsoft 365 email address (e.g. nemo@o365.thunderbird.net) you used in step 1 should be automatically entered into the Username field (if not, then correct it).
6. Follow the prompts and fill in the settings from your Exchange or Graph administrator. Full details at Custom OAuth for advanced users (scroll down to Per-account OAuth2 Microsoft Exchange customization).

Send and receive emails with your Exchange or Graph Account

Once you have configured your Exchange or Graph Account in Thunderbird, you can use it to send and receive emails just like an IMAP or POP account.

Limitations

Not yet supported:

• Address book
• Calendar
• OAuth authentication with on-premise instances
• Shared mailboxes

Feedback and Bug Reports

To report a problem when using version 157 or newer, please file a bug report.

To see open bug reports and more technical detail about bug reporting, tracking bug activity, plus things to test and look for, see the Thunderbird:Exchange wiki page.

You may use Topicbox to discuss or ask questions about Exchange, either the beta group or the enterprise group.

Microsoft hosted vs. self hosted Exchange and Graph servers

Administrators and others interested in the details of EWS and Graph instances (Microsoft hosted, Microsoft hosted as tenant-specific, and self hosted) will want to refer to the Thunderbird:Exchange wiki page and Thunderbird:Microsoft_Graph_API wiki page.