# Uploading Contacts in Bulk

### Steps

You can add contacts in bulk using a .csv file. To add contacts in bulk into the Marketing Engine, perform the following steps:

1. Click *Segments*.
2. Click *Contacts*.
3. Under Add New Contacts, click *Upload File*.&#x20;

   <figure><img src="https://167344003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsxN9AGLZMIc5C8dx3zU7%2Fuploads%2F4dnl2hMiI560Hw21neN1%2Fimage.png?alt=media&#x26;token=a52cb6ab-da7b-495b-a93e-6aa608ea3e5f" alt=""><figcaption></figcaption></figure>
4. In the "Upload Your File" section, you can upload a .csv file from your system. The file must include all contact details, with the email ID being a mandatory field.

{% hint style="info" %}
**Note:** To ensure a successful upload, we recommend downloading the sample .csv file and following its format when uploading your contacts in bulk.
{% endhint %}

<figure><img src="https://167344003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsxN9AGLZMIc5C8dx3zU7%2Fuploads%2FClTzp6GfsszWu8sOGIe3%2Fimage.png?alt=media&#x26;token=b7819e59-8f5b-4cd3-8f08-4353a56d5e42" alt=""><figcaption></figcaption></figure>

5. You'll see a preview of your file's contents. If everything looks correct, click *Next.*
6. **Map File**

In the *Map File* section, map the columns from your file to the corresponding contact attributes shown on the screen where you want to add the data.

{% hint style="danger" %}
Proper mapping allows Marketing Engine to segment your contacts later in the **Audience** section based on these attributes. If any column isn’t mapped automatically, you can select the correct attribute from the drop-down menu. If the required attribute doesn’t exist, you have the option to create a custom attribute to capture additional contact details.

For more information, refer to the section [**Creating Custom Objects & Custom Fields for Data Management**](https://docs.satisfilabs.com/resource-center/marketing-engine/segments/create-custom-object-and-custom-fields-for-contact-data-management)**.**

If your file contains headers that match Marketing Engine's contact attributes, they will be mapped automatically.&#x20;

Be sure to map the **email ID** field, as it is mandatory.
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdvL91-T7_p1-lRJIRoAhoPzIBJnOlw6l_Ynxes1R5kcwwPCc7ullI0Uu71t2I8oF2A_PtiSMKiobdcQxeqO1Z7yyHBZJ_WTlkJOaIlqJmEL9JO4XQuO6gLCPdN2JqoCvshMZI3?key=lYIuAOJZuDXXpIk3m9tRjyA5" alt=""><figcaption></figcaption></figure>

7. **Update SMS/WhatsApp Consent**

Before sending WhatsApp or SMS messages to your uploaded contacts, you must obtain explicit opt-in consent from them. WhatsApp notifications require prior consent, and in many countries, SMS marketing also requires customer consent.

To apply consent to your contacts, click **Update SMS/WhatsApp Consent.** You can choose to grant consent for either WhatsApp, SMS, or both. Consent can be applied to:

* **All contacts**, or
* **Specific contacts** by mapping the appropriate column in your uploaded file to the SMS and WhatsApp consent fields.&#x20;

  <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcdGOvXgm7mnhxhUqXhWMF6d_ZPb3yUfpaujqCvqvMlK-9uHLy38BCtqv67odfAZn2U5QEY8ntkaaOqGF3y0Baj_A9bfukQNUFXplgKeDLTznaYgZZwGFmmscPIbFZaqdbyx-XP?key=lYIuAOJZuDXXpIk3m9tRjyA5" alt=""><figcaption></figcaption></figure>

8. **Review & Confirm**

In this step, review and confirm the contact details before uploading.

* Selecting **"Overwrite existing contact details"** will update duplicate contacts with the data from your .csv file.
* Enabling **"Import empty fields to erase existing contact details"** will replace any existing information with blank fields from your .csv file.
* You also have the option to **blacklist** the imported email contacts.

Finally, ensure that your contacts have opted in to receive email marketing from you by checking the box under the **Opt-In Agreement.**&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc-VZP1HWGpPnSEvWZK9L1XMj2qVTdskTzuE0Rz9fgP1hI0vTTq9Wt_SqAGoC9haA7W6vYiqOWCc2ZhKRognP2EAohwrf8xXehn48Crg17BbQgi4eyoeQmrtS2WJ_ZEhiKbordmpg?key=lYIuAOJZuDXXpIk3m9tRjyA5" alt=""><figcaption></figcaption></figure>

9. Click Ok.&#x20;

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXetI8_av-ck7o4cqskygUAnQLJnKrvuc7E1Oeuqtu-Tm5l3xXOA6gGM9i98yblRKB3kyKuTofmKNqnt37nLYIJZ19Nm7n-ECBHXBRpGcS4RKk7GLCNZHYo0NzctNYZUyc52lOc5Bg?key=lYIuAOJZuDXXpIk3m9tRjyA5" alt=""><figcaption></figcaption></figure>
10. In the *Add to List Section,* you can either add contacts to an existing list or create a new one. To add them to an existing list, simply select it from the options. If you prefer to create a new list, click **"Create a New List,"** enter a name, and save your contacts to it.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcHWmdsi6fUyxWXWEpWJ1rX7PCXf9On-UBsjnp1o7HOB23IXw2DpM6GLSS4eFP3goBhc1IgQCL3FcYEPw61BwRx0riNVDkuAoKu7dGb_bdaSs-KK9KamSi5GBt6zREWqyJ0X_Oibg?key=lYIuAOJZuDXXpIk3m9tRjyA5" alt=""><figcaption></figcaption></figure>

11. You can assign tags to your uploaded list for better organization and segmentation.&#x20;
12. Click *Save*.

Once you click *Done*, you can see the import history, which provides details like the number of contacts in your file, the number of contacts successfully added, the number of invalid contacts, the status of the uploaded file, and more.&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdnlobWmhXSqLHMqmRuXz0iWueJn8Ipv4tVMoh0S86Is-jRcFFqpFVocfG6EuHGjAywihXMCV00mrPuuy6CZQwQVqBLUCb2ytgpylxJxxPKfaF8rriJcPO7wRa5e7fXu8ueVbuIHQ?key=lYIuAOJZuDXXpIk3m9tRjyA5" alt=""><figcaption></figcaption></figure>

You also have an option to download the error report, if any, to see the issue with the invalid contacts.
