The Contact Lists section is where you build and manage your audiences for messaging campaigns. By organizing users into lists, you can send highly targeted and relevant communications.

Here’s a breakdown of the functionality on this page:

You can create a new list in two primary ways:

Create an Empty List:
- Click the 'Create New List' button.
- In the dialog that appears, simply type a descriptive name for your list (e.g., 'Newsletter Subscribers' or 'VIP Customers').
- Click 'Create'. You can then add contacts to this list later.
Create a List by Uploading a CSV File:
- Click the 'Create New List' button.
- Instead of typing a name, you can directly upload a CSV file containing your contacts.
- The system will automatically create a new list, using the filename as the list name (which you can edit), and import all valid contacts from the file.

Managing Your Contact Lists

The main screen displays a table of all your existing lists with the following information:

List Name: The name you've given the list.
Contacts: The total number of contacts in that list.
Date Created: When the list was first created.
Actions: Clicking the trash can icon will open a confirmation dialog to permanently delete the entire list and all the contacts within it. This action cannot be undone.

Viewing and Managing Contacts Within a List

To see the individuals in a specific list, simply click on the list's name in the table. This opens the 'View Contacts' dialog, where you can:

Search: Quickly find a specific person by typing their name or phone number into the search bar.
Delete a Contact: Remove individual contacts from the list by clicking the trash can icon next to their name.
Add More Contacts: Click the 'Add Contacts' button to add more people to the current list. This gives you two options:
- Manual Entry: Add one person at a time by typing their name and phone number.
- CSV Upload: Upload another CSV file to add contacts in bulk to the list you are viewing.

CSV File Format for Uploading

For a successful import, your CSV file must have a header row containing a `number` column and either `name` or `firstname`/`lastname` columns.

The `name` (or `firstname`/`lastname` for split names) column(s) should contain the contact's name.
The `number` column must contain the phone number in the full international E.164 format (e.g., `+447123456789` for the UK, not `07123456789`).

Any rows in your file that don't follow this format will be automatically skipped during the import process.