Add or edit an Exchange connection

The steps to add an Exchange Online connection depend on what version of Google Workspace Migrate you're using:

• GWM version 2.4.16.0 or earlier (later on this page)
• GWM version 2.4.18.0 or later

Using Google Workspace Migrate version 2.4.16.0 or earlier

All dates mentioned are expected timelines only and are at the discretion of Microsoft. 

Important: If you're using Google Workspace Migrate version 2.4.16.0 or earlier, your existing Exchange Online connections will not work from February 2025 and you must update to a newer version of Google Workspace Migrate. For details, go to Deprecation of the ApplicationImpersonation role in Exchange Online.

1. In the Google Workspace Migrate platform, click New Connection.
2. For Name, enter a connection name.
3. For Account, select your account or take the following steps:
   1. Click Add new account, copy the code and click the Microsoft link.
   2. In the window that opens, enter the codeNext.
   3. Enter the email address of the Exchange administratorNextAccept after reviewing the permissions.
   4. Close the browser and return to the Google Workspace Migrate platform.
   5. Verify that your admin email address is listed.
4. (Optional) For List, select your user list.
5. Click Create.

Troubleshooting

• The authentication token associated with an Exchange Online connection expires if the connection is unused for 90 days. If this issue occurs, edit the connection, then repeat the previous steps.
• If you get a "The underlying connection was closed: An unexpected error occurred on a send" error, check that you allowed connections to the required URLs. For details, go to Additional requirements for Exchange Online. 

If you're migrating data from Exchange 2010, 2013, 2016, or 2019 follow these steps to add a connection.

1. If you're using Exchange 2010, create a user list. For details, see Create a user list.
2. In the Google Workspace Migrate platform, click New Connection.
3. For Name, enter a connection name.
4. For Type, select Exchange Server.
5. For Exchange version, select your version of Exchange.
6. For URL, enter the URL of the Exchange access client. To find the URL:
   1. Open Exchange and go to settings.
   2. On the left, click MailAccountsPOP and IMAP.
   3. Under POP setting, copy the server name.
   4. Add the server name to this URL: https://<server name>/EWS/Exchange.asmx.

      Note: The default URL for EWS is https://<mail.server>/ews/exchange.asmx.

7. For Account, depending on whether your Exchange administrator account is listed, choose an option:
   • Select your account.
   • Click Add new accountenter the administrator’s Exchange account username and password.
8. For List, select your user list.

   This step is required if you're using Exchange 2010, but optional for other versions.

9. Click Create.