Skip to main content
You will likely need to bulk-import contacts into your Engage enviroment, when starting up your Engage account, or migrating, or when updating certain data points. There are a number of ways this can be done. Each has its own dedicated article.
https://mintcdn.com/voyado/-QD3xMpfEY3BtcMt/icons/developer-link.png?fit=max&auto=format&n=-QD3xMpfEY3BtcMt&q=85&s=92be9e7202a0fc63f959e3f367cc7e32

Learn about working with the Engage FTP

Manual import as CSV files

When you have a small customer database of less than 500 000 records, manual import by CSV is the recommended way to import (or update) those contacts.
https://mintcdn.com/voyado/-QD3xMpfEY3BtcMt/icons/developer-link.png?fit=max&auto=format&n=-QD3xMpfEY3BtcMt&q=85&s=92be9e7202a0fc63f959e3f367cc7e32

See how manual imports by CSV are done

Automated import as XML files

For customer databases of 500 000 records or more, it is recommended to use the XML-importer. This is a more automated process where you export your contacts from your own database as XML files that are then placed on the Engage FTP server. From here they are imported by a scheduled job. This method has better high volume performance and superior error management. For this to work, the “ContactXmlImporter” module setting needs to be activated by your Engage team.
https://mintcdn.com/voyado/-QD3xMpfEY3BtcMt/icons/developer-link.png?fit=max&auto=format&n=-QD3xMpfEY3BtcMt&q=85&s=92be9e7202a0fc63f959e3f367cc7e32

See how automated XML imports are done

Contacts bulk API

Contacts can also be created and updated in bulk through a dedicated API endpoint.
https://mintcdn.com/voyado/-QD3xMpfEY3BtcMt/icons/developer-link.png?fit=max&auto=format&n=-QD3xMpfEY3BtcMt&q=85&s=92be9e7202a0fc63f959e3f367cc7e32

See how bulk API imports are done