beginner

Uploading an SMS Contact List and Sending an SMS Campaign

Import a CSV contact list with link fields and send an SMS campaign to that list

10 min readUpdated March 30, 2026

Uploading an SMS Contact List and Sending an SMS Campaign

Use this workflow when you want to send an SMS message that includes a link to an external system (for example, an external survey, landing page, or any URL you want to share).

Before you start

  • Prepare a CSV file with your contact data.
  • Include any custom fields you want to use in the SMS message (for example a links column).

Example CSV columns

Typical columns include:

  • full_number
  • first_name
  • last_name
  • links

Step 1: Create a new contact list

  1. Go to the SMS module.
  2. Open Contacts.
  3. Click New List.
  4. Enter a clear list name (for example: SMS Contacts - Links).

Step 2: Import your contacts (CSV)

1

Click Import CSV.

2

Select your CSV file.

3

Review the preview and verify the columns look correct.

4

Click Import.

After import, you can open an individual contact to confirm that any additional fields (like links) were stored correctly.

Step 3: Create an SMS campaign

  1. Go to Campaigns.
  2. Click New Campaign.
  3. Name the campaign.
  4. If you are not attaching this campaign to a Quali-Fi survey, you can skip that step.

Step 4: Select your audience

  1. Click Continue.
  2. Select the contact list you imported.
  3. Click Continue.

Step 5: Write the message and insert the link field

Use your uploaded column name as a message variable.

For example:

  • If your CSV column is named links, insert {{links}} in your message.
  • If your column is named link, insert {{link}}.

Step 6: Preview and send

  • Use the mobile preview to confirm the message looks correct.
  • Check whether the message will be split into multiple messages.
  • When ready, you can:
    • Save as a draft
    • Schedule the campaign
    • Send immediately

Tips

  • Keep SMS copy short and direct.
  • If you want to avoid splitting into multiple SMS messages, reduce message length and account for the full link length.

Related

Was this article helpful?