IMAP migration in the Microsoft 365 admin center
After you've added your users to Microsoft 365 or Office 365, you can use Internet Message Access Protocol (IMAP) to migrate email for those users from their IMAP-enabled email servers.
In the Microsoft 365 admin center, go to Setup > Data migration to start migrating IMAP enabled emails. The email migrations page is pre-configured for migrations from Gmail, Outlook, Hotmail and Yahoo. You can also enter your own IMAP server name and connection parameters to migrate from an email service that is not listed.
Before you can use an IMAP migration for your users, they must have been first added to your Microsoft 365 or Office 365 organization. For instructions, see Add users individually or in bulk.
Before you migrate, read What you need to know about migrating your IMAP mailboxes to Microsoft 365 or Office 365.
To perform an IMAP migration by using the Exchange admin center (EAC), see Migrate other types of IMAP mailboxes to Microsoft 365 or Office 365.
To migrate Exchange mail to Microsoft 365 or Office 365, see Use express migration to migrate Exchange mailboxes to Microsoft 365 or Office 365
Migrate IMAP mailboxes to Microsoft 365 or Office 365
Sign into the About the Microsoft 365 admin center.
Navigate to Setup > Data migration.
Select your data service dashboard opens.
Do one of the following steps:
Your provider is listed:
Choose the email provider you are migrating from.
If you're migrating email from Gmail, you need to ask your users to create an app password you will have to use instead of their account password. If you're migrating email from Outlook.com or Hotmail.com, you need to ask your users to set up two-step verification and obtain an app password. You will use their app password instead of their account password when you establish a connection between Outlook.com or Hotmail.com and Microsoft 365 or Office 365.
After you choose a provider, the Select users to start migrating email messages page will list all of your users with the source email pre-filled in.
Your provider is not listed:
Choose Other email sources:
On the Select your data service page, fill in the appropriate IMAP connection data to test the connection. You can use any account for this.
The example below is for a Google apps domain called contoso.com, and therefore the IMAP server name is imap.gmail.com.
Because the example is for Google apps, note that the password is the 16-digit app password for the email account that is entered to verify the connection to the server.
If you're migrating email from Google Apps where you own the domain, you need to ask your users to create an app password you will have to use instead of their account password.
Click Save to test the connection. Once the connection is verified, the Email Migration Status page will list all your added users with the email address that you provided.
This and the following steps apply for both a listed email provider or "Other":
Check the box next to the users whose email you want to migrate, and then fill in the email alias, and the password (app password if you are migrating mail from Gmail or Google apps).
Choose Start Migration after you have entered the required information.
The migration status will be one of:
When the status is Synced the IMAP migration will continue to synchronize with the source email periodically until you choose Stop Migration.
When you're done, choose Close Connection. This also allows you to start a new migration if you want to migrate emails from other providers as well.
If you are migrating from Google apps where you own the domain, you need to go Create DNS records at Google Domains for Microsoft after you have completed email migration so that the mail will be sent to Microsoft 365 or Office 365 mailboxes instead of Google apps. If you are migrating from another IMAP provider where you own the domain, check these instructions to find your domain provider.
If you have migrated as a part of the setup experience, you can return to the setup. The setup steps will guide you through updating the DNS records.