SMS Platform
Contact Lists
Organize SMS recipients into lists for bulk sending.
Contact lists are now groups in the contact book (Contacts in the dashboard), with custom fields, opt-out history, search and export. For importing Excel files, column mapping and the error file, see Bulk and personalised campaigns and the Contacts and groups and Imports APIs.
Contact lists help you organize recipients for bulk SMS campaigns.
Create a contact list
- Go to Contacts in the SMS dashboard
- Click Upload CSV
- The file name becomes the list name
Add contacts
Manual entry
Add contacts one at a time with phone number and optional name.
CSV import
Upload a CSV file to bulk-import contacts:
phone,name
+254712345678,Alice
+254712345679,Bob
+254712345680,Charlie- The phone column is detected from the header (
phone,phone_number,mobile,msisdn,toornumber). Every other column becomes a variable you can use in the message (for example{{balance}}). - Numbers are stored in international E.164 format. Numbers with a country code
(
+256772123456or256772123456) work anywhere; local numbers (0772123456) are read in your account's country, or in thedefault_countryyou send with the upload (API). - Invalid numbers and duplicates are skipped. The upload result tells you how
many (
invalid_count,duplicate_count) and lists the first invalid rows with their row number.
Send bulk SMS
- Go to Send SMS
- Select your sender ID
- Select a contact list as the recipient
- Compose your message
- Click Send
Each message is charged individually based on the recipient's country pricing.
Managing lists
- View contacts - Browse and search contacts in a list
- Export - Download a list as CSV
- Delete - Remove a list and all its contacts permanently