eSMS AfricaeSMS Africa
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

  1. Go to Contacts in the SMS dashboard
  2. Click Upload CSV
  3. 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, to or number). 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 (+256772123456 or 256772123456) work anywhere; local numbers (0772123456) are read in your account's country, or in the default_country you 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

  1. Go to Send SMS
  2. Select your sender ID
  3. Select a contact list as the recipient
  4. Compose your message
  5. 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

On this page