Import contacts
This article applies to Dynamics 365 Customer Engagement (on-premises) version 9.1 using the legacy web client. If you’re using Unified Interface, your apps work the same as Unified Interface for model-driven Power Apps. For the Power Apps version of this article, see: Import data
Whether your contacts are stored in an email program, a spreadsheet, or on your phone, here's how to import them into Dynamics 365 Customer Engagement (on-premises) so you have all your business contact information in Customer Engagement (on-premises).
Step 1: Get your import file ready
First, you export your contacts into a file. These file formats are supported:
Comma-separated values (.csv)
Text (.txt)
Compressed (.zip)
Excel Spreadsheet 2003 (.xml)
The maximum file size allowed for .zip files is 32 MB. For the other file formats, the maximum file size allowed is 8 MB.
Tip
If you store contacts in more than one program, add your import files to a single .zip file. Then import the .zip file to bring in all the files at once.
Next, follow the procedure for the program or location where your contacts are stored.
Export contacts from an email program
Export the contacts into a comma separated values file (.csv).
To find specific steps to export contacts from your email program, open the program's Help, and search for "export." Look for topics that include "exporting contacts" or "exporting your address book" or "export wizard" in the title.
Save the file in a location where you can find it easily later.
Export contacts from a spreadsheet
Open the spreadsheet.
If necessary, edit any column name in the spreadsheet to match exactly with the corresponding name shown here.
Warning
If the spreadsheet doesn't include all the column names listed, that's okay. However, if a column name does exist, it must match exactly with the corresponding name in the list or the import won't work. Spaces are required. Note that the word "Email" doesn't contain a hyphen.
Column Name in Spreadsheet (spelling must match exactly) First Name Middle Name Last Name Business Phone Mobile Phone Job Title Business Street Business City Business State Business Postal Code Business Country/Region Email Address Save the file.
Export contacts from your phone
Use a USB cable or an app to export your contacts from your phone to your computer.
To find specific steps to export contacts for your brand of phone, search for "export contacts from my phone" in your favorite search engine (like Bing).
To find an app, search your phone's online store.
Step 2: Import the file
You'll use the Import Data wizard to import your contacts.
Go to Settings > Data Management > Imports.
On the command bar select Import Data > Import Data.
. Browse to the folder where you saved the file that contains the export of your contacts. Select the file, and then select Open. select Next.
Tip
You can import only one file at a time. To bring in more files, run the wizard again later, or add all your contacts files to a single .zip file.
Review the file name, and if the file is in .csv or .txt format, verify that the field and data delimiters are correct. Select Next.
Note
In most cases, you can accept the default delimiters.
Select Default (Automatic Mapping) for the System Data Map. Select Next.
In the Dynamics 365 Customer Engagement (on-premises)Record Types drop-down list, select Contacts. Select Next.
For any record type with an alert icon, map the column from your contacts file to the corresponding field in Dynamics 365 Customer Engagement (on-premises). Select OK, and then select Next.
Review the summary, and then select Next.
Select Submit.
To verify that the wizard was successful, select Imports, then review the report. Otherwise, select Finish.
Step 3: Check that the contacts imported successfully
After the wizard finishes, check your list of contacts to make sure they imported correctly.
Select your role (either Sales, Service, or Marketing). Go to Contacts.
Scroll through the contact list. Check that each person is listed and verify the contents of the fields for accuracy.
If needed, learn about removing duplicates: Merge duplicate records for accounts, contacts, or leads.
See also
This topic applies to Dynamics 365 Customer Engagement (on-premises). For the Power Apps version of this topic, see: Import data
Whether your contacts are stored in an email program, a spreadsheet, or on your phone, here's how to import them into Dynamics 365 Customer Engagement (on-premises) so you have all your business contact information in Customer Engagement (on-premises).
Step 1: Get your import file ready
First, you export your contacts into a file. These file formats are supported:
Comma-separated values (.csv)
Text (.txt)
Compressed (.zip)
Excel Spreadsheet 2003 (.xml)
The maximum file size allowed for .zip files is 32 MB. For the other file formats, the maximum file size allowed is 8 MB.
Tip
If you store contacts in more than one program, add your import files to a single .zip file. Then import the .zip file to bring in all the files at once.
Next, follow the procedure for the program or location where your contacts are stored.
Export contacts from an email program
Export the contacts into a comma separated values file (.csv).
To find specific steps to export contacts from your email program, open the program's Help, and search for "export." Look for topics that include "exporting contacts" or "exporting your address book" or "export wizard" in the title.
Save the file in a location where you can find it easily later.
Export contacts from a spreadsheet
Open the spreadsheet.
If necessary, edit any column name in the spreadsheet to match exactly with the corresponding name shown here.
Warning
If the spreadsheet doesn't include all the column names listed, that's okay. However, if a column name does exist, it must match exactly with the corresponding name in the list or the import won't work. Spaces are required. Note that the word "Email" doesn't contain a hyphen.
Column Name in Spreadsheet (spelling must match exactly) First Name Middle Name Last Name Business Phone Mobile Phone Job Title Business Street Business City Business State Business Postal Code Business Country/Region Email Address Save the file.
Export contacts from your phone
Use a USB cable or an app to export your contacts from your phone to your computer.
To find specific steps to export contacts for your brand of phone, search for "export contacts from my phone" in your favorite search engine (like Bing).
To find an app, search your phone's online store.
Step 2: Import the file
You'll use the Import Data wizard to import your contacts.
Go to Settings > Data Management > Imports.
On the command bar select Import Data > Import Data.
. Browse to the folder where you saved the file that contains the export of your contacts. Select the file, and then select Open. select Next.
Tip
You can import only one file at a time. To bring in more files, run the wizard again later, or add all your contacts files to a single .zip file.
Review the file name, and if the file is in .csv or .txt format, verify that the field and data delimiters are correct. Select Next.
Note
In most cases, you can accept the default delimiters.
Select Default (Automatic Mapping) for the System Data Map. Select Next.
In the Dynamics 365 Customer Engagement (on-premises)Record Types drop-down list, select Contacts. Select Next.
For any record type with an alert icon, map the column from your contacts file to the corresponding field in Dynamics 365 Customer Engagement (on-premises). Select OK, and then select Next.
Review the summary, and then select Next.
Select Submit.
To verify that the wizard was successful, select Imports, then review the report. Otherwise, select Finish.
Step 3: Check that the contacts imported successfully
After the wizard finishes, check your list of contacts to make sure they imported correctly.
Select your role (either Sales, Service, or Marketing). Go to Contacts.
Scroll through the contact list. Check that each person is listed and verify the contents of the fields for accuracy.
If needed, learn about removing duplicates: Merge duplicate records for accounts, contacts, or leads.