Create an audience and import contacts
Build a contact list from a CSV, read its reachability, find one person in it, and see who has opted out.
An audience is a named list of contacts a campaign can send to. Every contact needs a phone number; everything else is optional.
Create an audience
- Open Audiences and press New audience.
- Enter a Name, then choose Add one contact or Import CSV/JSON.
- Press Create audience.
To add people later, open the audience and press Add contact or Import more.
Import a CSV
Press Upload file, or paste the rows into the box. The first line is the header:
firstName,lastName,number,email
Ada,Lovelace,+15551234567,ada@example.com
- Common spellings work too:
phone,mobileortelfor the number,first name,surname. - Write numbers with the country code (
+44…,+1…). - A
tagscolumn (split by commas or semicolons) becomes tags you can segment on. - Every other column stays on the contact as a field for your templates — see Personalise a template with contact fields.
The dialog shows how many rows were parsed and skipped (blank rows) before you import. If any row has a number that cannot be messaged — a name in the number column, an unknown country code, a country code typed twice — the whole import is refused and the message names the first bad number. Fix the file and import again.
Reachability
Every number is scored at import, offline and at no cost, and the audience shows the split: Reachable, Landline, Unknown, Unreachable, No number. Most US and Canadian (+1) numbers read Unknown: mobiles and landlines share the same ranges. Hover the label next to a number for the evidence and the date it was checked. A score is a likelihood, not proof the person has WhatsApp — and nothing is removed for you. When you build a campaign, you choose whether to Leave out unreachable numbers.
Find a contact
The search box above the table (Name, number or email) searches the whole audience, not just the page on screen, and a number matches however it is written — with spaces, brackets or dashes. The chips beside it (Delivered, Failed, Never messaged …) filter by each contact's last message; Save as audience copies the filtered set into a new list.
The Opted out column
A contact who replies STOP is opted out for your whole organization. The Opted out column shows Yes for that number in every audience, including ones you import it into later. Campaigns skip it, and the Inbox will not send to it. Removing a contact from an audience (the bin icon) only takes them off that list — it does not opt them out.
Too large to summarize
The Last campaign column on the Audiences list summarizes up to 10,000 contacts at a time, smallest lists first. A list that does not fit says Too large to summarize — nothing is wrong with it. Open it to see its contacts.
Last reviewed November 9, 2026