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
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_LINKbecomes{survey_link}andDonor Tierbecomes{donor_tier}. - A header that starts with a digit gets a
field_prefix, so2024 Votebecomes{field_2024_vote}. - A name that would repeat gets a numeric suffix, such as
_2.
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.
