---
title: "Set Up Data Imports"
slug: "set-up-data-imports"
updated: 2025-01-31T13:53:18Z
published: 2025-01-31T13:53:18Z
---

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

# Set Up Data Imports

Data imports are a powerful tool for syncing data from external sources into your Mapp Engage system.

## Prerequisites

Configure your connections (including path and wildcard) to set up data imports in the [Credentials](/v1/docs/credentials) section. This is the case for both FTP and HTTP connections.

## Common Use Cases

- Add contacts to Mapp Engage
- Update contact attributes in Mapp Engage
- Remove users from Mapp Engage
- Send an email (prepared message) with parameters to contacts
- Add data to your custom Related Data tables where their email is the key attribute
- Add multiple location data to your location database
- Add data to predefined Related Data: Transactions, Wish List, and Abandoned Cart

> [!NOTE]
> **Option to skip unsubscribers**
> 
> Since September 2024, you can add a column to your imported CSV called `skipUnsibscribers`. This is a boolean, that when `TRUE` will check whether the contact has unsubscribed. If they have, they will not be re-added to the group. If the parameter is empty or set to `FALSE`, they will not be checked.

## Procedure

### A) Create an integration via Mapp Connect

To see the setup steps, visit [Create an Integration](/v1/docs/create-an-integration). Data Feeds are set up like a generic integration in Mapp Connect.

---

### B) Set up an import job

> [!NOTE]
> With one job you can import a few files that fit the wildcard and are of the same data type (e.g. User, Transaction, Email, Abandoned Cart, Wishlist, Location). **Only the “*” wildcard is supported.**

1. Go to the **Data Import** tab and click **Add New Import**.
2. The Import Configuration tab opens. Here, you can define all the details of the import job:
  1. **Add job name**. The name has to be unique.
  2. **Runs every**. Here, you can specify a detailed schedule for your job.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(548).png)
  3. **Set job status**. Select **Enabled** or **Disabled** here.

> [!WARNING]
> Only set the job status to **Enabled**when all columns for incoming data are mapped.

### C) Define import steps

1. **Import from FTP/SFTP** **or HTTP.** Select the connection from the drop-down list and click **Test Connection**. If the connection test fails, you will receive an alert. If you are importing via HTTP, you can also add the file path here if you didn’t include it when [setting up your credentials](/v1/docs/create-new-record-window).

![Settings for importing files via FTP or HTTP with various options available.](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/conn wildcart(1).PNG)

> [!NOTE]
> **Only the “*” wildcard is supported.**

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(604)(1).png)
2. *(optional)***Unarchive file**. To remove this step from the import workflow, click the minus icon:

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(555).png)

**Supported formats** are .zip, .tar, .gz, .tar, and .gz. If a password protects the archived file, you can enter it here. This option is only available for the .zip format.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(552).png)
3. *(optional)***Convert file**. To remove this step from the import workflow, click the minus icon:

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(555).png)

> [!NOTE]
> Note that if you import multiple files, encoding and delimiter must be the same for all the files.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(556).png)
4. **Upload to S3**. This is when the data is uploaded to Mapp's S3 server. This step cannot be configured.
5. **Create event**. This step allows you to define what happens with the data upon import.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(557).png)
6. This step provides an import report from Mapp Engage.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(558).png)
7. **Update mapping**. Click on **Edit Mapping** and adjust it as needed. For more details about mapping, visit [Edit Mapping](/v1/docs/edit-mapping).

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(559).png)
8. (*optional*) Add monitoring users. Here, you can add the email addresses of people who should be receiving error logs from the system.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(560).png)
9. Click **Save**.

---

### D) View imports & monitor import progress

You can see all the created imports on the **Data Import** tab.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(562).png)

Click the plus icon next to the **Log Report**label to check the import status.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(564).png)

## Related

- [Edit Data Transformations](/edit-data-transformations.md)