Importing contacts allows you to convert your contact base to Messaging quickly and easily. In this article we will learn how to import contacts.

To start the import, go to the Contacts section and click the ellipsis (the three stacked dots) in the upper-right side of the page. Choose “Import Contacts”.

nullFigure 1. Choosing the Import Contacts Function

Now you are on the page with an opt-in agreement. Check the box to confirm that your contacts permitted sending campaigns, were not borrowed from a third party, or purchased or rented. Click “Next”.


Figure 2. Opt-in Agreement Page

On the next page, you need to upload a file with your contacts. There are some requirements to your file:
It should have a CSV or XLSX format.
Maximum size of the file is 50 MB; maximum number of rows is 5000.
The first row must contain the column headings that must follow in succession without empty cells. 

Only the first sheet will be imported. Contacts with the same email addresses will not be imported.

Download your file and click “Next”. 

nullFigure 3. Uploading a File with Contacts

nullFigure 4. A File with Contacts Uploaded

Now let’s choose import rules. There are two options. You can add new contacts without updating existing ones.


Figure 5. Choosing Import Rules

Also, you can add new contacts and update existing ones. If you choose this option, another one appears: you can import a file with empty cells that will erase data in corresponding already present cells. Enable a toggle to do this. If this option is disabled, the empty cells will not affect your already present data. 


Figure 6. Choosing Import Rules

On the page with import rules you can also add tags to contacts. 


Figure 7. Adding Tags

Once you choose import rules and add tags, click “Next”.


Figure 8. Import Rules Chosen

You should find yourself on the Mapping Data page. Here the correspondence of Messaging fields and fields from your file is shown.


Figure 9. Mapping Data Page

Your file can’t be imported without an email address. Make sure that the email fields are mapped. If not, you will see an error notification. 

nullFigure 10. Error Notification (the Email Fields Aren’t Mapped)

You can map fields on this page manually if they aren’t mapped automatically. To do this, click on the “Do Not Import” button. You can choose custom or general fields from the dropdown list.

nullFigure 11. Mapping Fields Manually

nullFigure 12. Mapping Fields Manually

You can continue without mapping fields (but email fields should be mapped). In this case, you will need to confirm this action by clicking “Yes, continue” after clicking “Confirm Import”.

nullFigure 13. Confirming Import without Mapping Fields

You can also change your file on the Mapping Data page. Click the “Change File” button, then click “Confirm”. You will be redirected to the file uploading page where you can delete the previously uploaded file and upload a new one.

nullFigure 14. Changing File

nullFigure 15. Changing File


Figure 16. Changing File

If everything is correct on the Mapping Data page, click “Confirm Import”.

nullFigure 17. Confirming Import

After clicking the confirmation button, the import process will start. It will take some time.


Figure 18. Notification about Import in Progress

While the import is in progress, you can’t start another import. The “Import” button will be disabled as well. Once the import is complete, you can start importing again.null

Figure 19. The Import Button Disabled

There are four options of import results. Let’s have a look at them. 

1. Successful import: all your contacts were imported. We recommend you immediately send a blast to new contacts to make sure that they want to receive your emails. You can use the Welcome Email Blast template by clicking the “Create Welcome Blast” button.

nullFigure 20. Successful Import Notification

2. Contacts were imported with errors: import was completed, but some contacts were not imported for different reasons. Click the “View Details” button to see what exact contacts weren’t imported. On the Import History page you can download a needed report. After that, update your file and upload it again.

nullFigure 21. Import with Errors Notification

3. Import error: contacts have not been uploaded. Possible reasons for this could be an incorrect file format or connection problems. We recommend that you check the file format and upload the contacts again.

nullFigure 22. Import Error Notification

4. Import blocked: the number of contacts that could not pass the verification exceeded the limit. The contacts that agree to receive emails should only be found in the imported file. We recommend that you check the contacts using third-party services. Then remove invalid contacts and retry the import.

nullFigure 23. Import Blocked Notification

To learn more about import errors, please see the article Overview of Import Problems in Messaging.


Now you can import contacts in Messaging. To continue exploring contacts, you can see the article TruMESSAGING Contacts Overview.