---
title: "Lists"
slug: "lists"
description: "The user manual provides comprehensive guidance on using the Antavo Management UI for managing loyalty programs."
updated: 2025-08-28T13:36:25Z
published: 2025-08-28T13:36:25Z
canonical: "docs.antavo.com/lists"
---

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

# Lists

Customer lists share similarities with customer segments, but with one distinct difference: you can have the flexibility to manually add customers of your choice to the list, without setting predefined rules that automatically add customers. You can add or remove customers from lists anytime manually or [through API](https://developers.antavo.com/reference/post_v1-bulk-operation-customer-list-add-customer-list-id) as well.

When you navigate to the Customer Lists tab of the Customer Insights menu, you’ll find the list of lists that have already been added. The status label below the list's name indicates whether it is *active*, *inactive,* or *archived*.

![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/customer_lists.png)

### Create a new list

- Navigate to the Customer lists page
- Click the**Create** button
- Enter the **name of the list** and click **Create**

You can edit the list name anytime using the **Edit** button.

### Add members to a list

- Go to the **Customer Lists > View** page
- Click the **Open** button of the list you would like to add members to
- Under the**Add new member** section, type the**name or the email address** of the customer
- Once you find the customer you want to add, click the corresponding **Add** button

### Delete members from a list

- Go to the **Customer Lists > View** page
- Click the **Open** button of the list you would like to delete members from
- Once you find the customer you want to delete, click the corresponding **Remove** button
- Confirm your decision in the dialog

### Access Bulk Operation Requests

To access the status and errors of [bulk customer list operation API requests](https://developers.antavo.com/reference/get_v1-bulk-operation-customer-list-batch-id-status), navigate to**Customer Lists > Bulk Operation Request Queue**.

Details displayed on this page include:

| **Type** | The type of customer list operation (e.g., customer_add, customer_remove) |
| --- | --- |
| **Status** | The current status of the bulk operation process |
| **Customer List ID** | The ID of the customer list associated with the specific bulk operation process |
| **Batch ID** | The unique identifier for the specific bulk operation process |
| **Number of Customers** | The count of customers related to the specific bulk operation process |
| **Number of Errors** | The total number of errors encountered during the specific bulk operation process |
| **Created at** | The date when the process was initiated |

By clicking the**Errors** button, you can access detailed error information regarding the specific process, including the customers involved in the error, the error code, and the error message.

### Bind lists to your loyalty offers

You can use lists in 3 of the loyalty modules:

- [Rewards](/v1/docs/rewards): Define the list(s) of members who can claim a specific reward.
- [Challenges](/v1/docs/challenges): Define the list(s) of members who can earn loyalty points for completing specific challenges.
- [Offers](/v1/docs/offers): Define the list(s) of members who can claim and redeem a specific offer.