Customer lists

Contact lists allow you to target specific audiences within your Customer Journeys by uploading custom CSV files. You can create, manage, and export these lists directly from the Audiences section of the console.

Navigating to Contact Lists

In the console's left navigation menu, click Audiences.
Select the Journey tab.
Under Journey contacts, select Contact lists.

(The alternative tab, Groups of interest, segments journey contacts dynamically based on behavioral criteria rather than static file uploads).

List Overview & Search

The Contact lists dashboard displays the total number of lists configured in your project, structured into the following columns:

Name: The name assigned to the list upon creation.
Created at: The date and timestamp when the list was generated.
Contacts: The total number of valid contacts contained in the list.

To locate a specific list, enter its name into the Search by name field above the table.

Managing Existing Contact Lists

Click the more options menu (⋮) at the right end of any row to access list actions:

Edit: Modify the list details or settings.
Download associated contacts: Export the contacts and variables from that specific list as a CSV file.
Delete: Permanently remove the list from your project.

Important: Before deleting a list, ensure it is not actively referenced by any running Customer Journey, as removing an active list may cause journey triggers or message nodes to fail.

Creating a Contact List

In the Contact lists view, click + Create list.
In the Create contact list side panel, enter a recognizable Name (such as the target campaign or audience segment).
Click Upload file and select your prepared .csv file.
Verify the uploaded file details:
- File name: Displays under the upload area. Click the × icon to remove and replace the file if needed.
- Contact count: Displays in the panel footer (e.g., File: 72 contacts). Confirm that this count matches your source data.
Click Create.

Note: The Create button remains disabled until a valid .csv file is uploaded. Click Cancel at any time to close the panel without saving changes.

Once created, the new list appears immediately in the table with its creation date and contact count.

CSV File Requirements

Before creating a contact list, prepare a .csv file formatted according to platform requirements.

customerId: Mandatory. This serves as the unique identifier for each contact in indigitall. The platform cannot process or create the list without this header.
Personalization Columns (Variables)
If your journey messages use dynamic personalization (e.g., first names, cities, promo codes), include a dedicated column for each variable. Column headers must match the exact variable names used in your message templates.
```
customerId,name,city
10001,Laura,Madrid
10002,James,Chicago
10003,Ana,Bogotá
```

Remember that the essential field for identifying customers in the journey is customerId (the column header must be named exactly this way).