Skip to main content
Estimated time: 15–30 minutes

Overview

Import your lists and organize them for targeted messaging. One list can hold phone numbers, emails, or both, and every list is on one page: Assets > Lists. Each list card shows its phone numbers and, when it has emails, an Emails section with the total, sendable, unsubscribed, and bounced counts and a quality grade. Deleting a list removes its phone numbers and its emails. Use carrier lookup to validate numbers and filter out landlines.

Tasks to complete

1

Prepare Your Contact List (CSV)

Format as CSV with a phone number column (10-digit format), an email column, or both, and any other columns you want to use as merge tags, such as first name, last name, city, state, and zip. Use a clear header on every column. Phone numbers must be in the United States, Canada, or a US territory; a number in any other country cannot be texted, so it is counted with the list’s bad numbers and left out. One list holds phone numbers and emails together, so there is no need to split a file by channel.
2

Upload Contacts

Navigate to Assets > File Uploads. Under Upload to, choose who owns the files (a brand, a registration, a short code, a shared number, or Global), then drop up to 10 files at once. Files are sorted for you: CSV and TXT files become lists, images and videos go to the media library, and a mixed drop is fine.Your list files share one setup card. Under What is this?, choose Audience (people to send to) or Do not contact once for the batch. For each file, choose the phone column, the email column, or both; they are pre-filled from the file, and L2 and Aristotle voter files have their cell phone column found for you. The emails belong to the whole organization the list is uploaded to. For an audience with an email column, one unchecked checkbox, This list was purchased or rented, marks a purchased or rented list, which is sent more gradually. By default every other column becomes a merge tag automatically; you can choose which columns to map instead (see Merge tags from your columns). Maximum 1 million rows per upload. Phone number format is checked automatically.An audience file can also tag the people in it: tag everyone in the file, or name a column that holds each row’s tags, separated by commas, semicolons, or pipes. A do-not-contact file takes no tags. See Tags.
3

Run Carrier Lookup (Recommended)

Enable carrier lookup during import to identify landlines, validate numbers, and detect carrier information. Prevents wasted sends to landlines. A list cannot be used on a project until its analysis finishes.
4

Create Contact Segments

Organize contacts into groups based on location, voter data, or custom fields for targeted campaigns. A segment can create a new list, or tag the contacts its rules match instead, so you can send to the tag without making a list. See Tags.
5

Manage Opt-Outs

STOP replies are recorded automatically and applied to every send. To add your own do-not-contact file, upload it and choose Do not contact: its phone numbers become an opt-out list and its emails are recorded as unsubscribes in the background (minutes for a large file). Both show under Assets > Lists > Do not contact.

Pro tips

  • Always run carrier lookup to filter landlines before sending - it saves money.
  • Keep opt-out lists clean - never message opted-out contacts.
  • Use custom fields to store voter data, polling responses, or donation history.
  • Segment contacts before creating projects for better targeting.
  • Use tags to label contacts once and send to them from any project or email campaign. A tagged contact is still only texted or emailed through a list they are on, so tagging never replaces consent. See Tags.
  • Raising money on WinRed? Create a WinRed list under Assets > Lists and paste the generated webhook URL into WinRed’s integration settings - donors and leads flow into the list automatically, with donor details available as merge tags. A WinRed or Anedot feed is one list: its donors’ phone numbers and emails are on the same list.
  • Use the By Area Code segment operation to carve a list geographically, and org-wide segments (“All brands” / “All projects”) to build audiences like “everyone who clicked a link in any project.”

Merge tags from your columns

When you upload a list, Map all columns automatically is selected, and every column except the phone and email columns becomes a merge tag.
  • A column whose header matches a standard field gets the standard tag. Standard fields are first name, last name, address, address line 2, city, state, and zip. Common aliases match too, such as “First”, “FName”, and “Zip Code”. A first name column gets {first_name}.
  • Every other column gets a tag named after its header, in lowercase with underscores. SURVEY_LINK becomes {survey_link} and Donor Tier becomes {donor_tier}.
  • A header that starts with a digit gets a field_ prefix, so 2024 Vote becomes {field_2024_vote}.
  • A name that would repeat gets a numeric suffix, such as _2.
To decide for yourself, select Choose which columns to map. Only the columns you map get a merge tag. If you map none, all columns are mapped automatically. The list’s page has a Fields section that shows each column and its merge tag. Select Edit fields to rename a tag, switch a column to a standard tag, or remove a tag. This works for uploaded lists and segments. This applies to lists created from now on. Lists you uploaded earlier are unchanged. Do not contact uploads have no merge tags. Importing through the API? See merge_tags on Import List. Reading a list through the API returns its available merge tags.

Segment and split by carrier

In the Segment Builder, the By Carrier operation groups a list by mobile carrier: AT&T, Verizon, T-Mobile, Other carriers, and Unknown, each with its contact count. It combines with the other operations, so you can, for example, keep one area code and only Verizon numbers. On an analyzed list’s page, the Split by carrier card creates one new list for each carrier you select. The new lists keep the source list’s analysis, so there is no second analysis charge. A list that has not been analyzed shows all of its contacts under Unknown; run carrier lookup first to get real groups.

Next step

Step 4: Create Your First Messaging Project

With contacts organized, you’re ready to create your first messaging project.