A Customer list is a static list of customers. When you upload a customer list, if a customer in the customer list does not exist in Blueshift, a profile is created.

 You can use customer lists for different reasons. For example:

  • To add additional customers not already added in Blueshift.
  • Withhold a randomly selected set of customers from being messaged for purpose of a "control" group.
  • Use in a segment to simply send an email to an externally generated list of emails.

Note: You cannot use a customer list to add or update customer attributes. To add or update attributes for customers, upload data from Customer Data > Profiles in the left navigation.

Data format

  • A customer list must be a .txt or .csv file with one email, phone number, or customer_id per row.
  • Do not include any headers.
  • Do not include any attributes.

View customer lists

To view uploaded customer lists or customer lists created from segments, go to Customers Data > Lists.

You can view, edit, or remove a customer list.

You can also export a customer list in CSV format to your email address.

  Note

You cannot remove a customer list that is being used in an active segment or active campaign.

Customer-Lists-2.png

Create a new customer list

To create a new customer list, complete the following steps:

  • Go to Customer Data > Lists and click + CUSTOMER LIST > File Upload.
New-Customer-List.png
  • Select the File to upload. For file and data format, see Customer data format.
  • Enter a Name for the list.

  Customer list naming tip

Lists are shown together in a single view, and the identifier type is not visible. To make lists easier to recognize later, consider adding the identifier to the name.

Example: SeedList_Email_QA, SeedList_Phone_SMS, Import_CustomerID_Jan2026

  • Select the customer Identifier you are using to identify customers. Available options are:
    • Email
    • Phone number
    • Customer ID
  • Sample data is fetched from the file.
  • Verify the sample data.
  • Add a Description.
  • Click Upload.

View customer list details

Click a list or click Edit in the actions menu to view the list details.

The Properties tab shows the customer list detail and also lists the campaigns and segments that the customer list is used in.

Customer-List-Properties.png

Update the customer list name

After you create customer lists, either by uploading a list or from a segment, you can edit the name of the list.

When you view the customer list, go to the Properties tab and click the Edit (pencil) icon next to the list name.

Update customer list

You can update an existing customer list to add more customers from the list, delete customers from the list, or overwrite an existing list

Note: You cannot update a customer list that is created from a segment. 

To update a customer list, complete the following steps:

  • When you view the customer list, go to the Update Customer List tab.
  • Select the File that has the list of customers.
  • Select the option to either Append to the list, Delete from the list or Overwrite existing list
  • Sample data is fetched from the file.
  • Verify the sample data.
  • Click Update.

  When a list shows ‘fail’

If all records in your uploaded file are invalid during an overwrite, the list status changes to fail. This means the file couldn’t be processed. Fix the data and upload the file again to retry.

Create a customer list from a segment

You can split any segment into randomized lists and target different campaign variants at different lists.

For more information, see Split segments into lists.

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.