> ## Documentation Index
> Fetch the complete documentation index at: https://developer.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importing historical contacts

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.

<Card title="Learn about working with the Engage FTP" href="/docs/file-based-transfer/about-file-based-transfer" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399" horizontal width="128" height="128" data-path="icons/developer-link.png" />

## 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.

<Card title="See how manual imports by CSV are done" href="/docs/file-based-transfer/contact-csv-import" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399" horizontal width="128" height="128" data-path="icons/developer-link.png" />

## 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.

<Card title="See how automated XML imports are done" href="/docs/file-based-transfer/contact-xml-import" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399" horizontal width="128" height="128" data-path="icons/developer-link.png" />

## Contacts bulk API

Contacts can also be created and updated in bulk through a dedicated API endpoint.

<Card title="See how bulk API imports are done" href="/docs/contacts/bulk-contacts-api" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399" horizontal width="128" height="128" data-path="icons/developer-link.png" />
