Oops! Facing network problem. Unable to load this page. Refresh

Please Wait...

Hello Guest

logo

FAQs

Help
Center

SMS Marketing

Import SMS Contacts

Upload mobile numbers using Excel or CSV.

Overview

Importing contacts into SPRL allows you to quickly build recipient lists for SMS campaigns. Contacts can be added manually, imported from a CSV file, or organised into Contact Groups for future campaigns.

Using Contact Groups makes it easy to send SMS to the same audience repeatedly without entering mobile numbers each time.

Good to Know:
A CSV import supports up to 50,000 records per file. The mobile number is the only mandatory field, while additional personalization fields can be added when creating a Contact Group.

Contact Management Options

Navigate to Dashboard → Contacts to manage your SMS contacts.

Option Description
Add Contacts Add one or more mobile numbers manually.
Import Contacts Upload contacts using a CSV file.
Export Contacts Download contacts from an existing Contact Group.
Connect to Domain Import contacts from your own API endpoint.

Create a Contact Group

Before importing contacts, create a Contact Group to organise your recipients.

  1. Navigate to Dashboard → Contacts → Contact Groups.
  2. Click New Contact Group.
  3. Enter the Group Name.
  4. Select the personalization fields you want to store.
  5. Add any remarks if required.
  6. Click Add Group.

Available Personalization Fields

These fields can be stored for each contact and later used for SMS personalization.

Field Description
Contact No Recipient mobile number.
Full Name Recipient's complete name.
First Name Recipient's first name.
Last Name Recipient's surname.
Email Address Recipient email address.
Location City or location information.
Custom Fields Add additional personalization fields using Add More.

Import Contacts Using CSV

  1. Click Import Contacts.
  2. Select the Contact Group.
  3. Choose your CSV file.
  4. Click Upload Contact.
  5. The contacts will be added to the selected group.

A formatted CSV sample can be downloaded directly from the import screen.


CSV Requirements

Requirement Value
File Format CSV (.csv)
Maximum File Size 5 MB
Maximum Records 50,000 contacts
Mandatory Field Contact-No
Mobile Number 10-digit Indian mobile number.

Add Contacts Manually

If you only have a few recipients, you can add them manually.

  1. Click Add Contacts.
  2. Select the Contact Group.
  3. Enter one or more mobile numbers separated by commas.
  4. Click Add Contact.

Import Contacts Using Your API

Instead of uploading a CSV file, SPRL can retrieve contacts from your own API endpoint.

Setting Description
Group Name Select the Contact Group to receive imported contacts.
Request URL Your API endpoint.
Request Method Select the HTTP request method.
Parameters Add request parameters if required.

Your API response should return contact numbers in the expected format before validating the connection.


Manage Contact Groups

Each Contact Group includes additional management options.

Action Description
Add / View Contacts Manage contacts within the selected group.
Create Duplicate Group Create a copy of an existing Contact Group.
Rename Group Change the Contact Group name.
Delete Remove the Contact Group when it is no longer required.

Best Practices

  • Create separate Contact Groups for different customer segments.
  • Use personalization fields whenever available.
  • Download and use the formatted CSV template before importing contacts.
  • Verify that mobile numbers contain valid 10-digit Indian numbers.
  • Keep Contact Groups updated by removing outdated or invalid contacts.
  • Test imports using a small CSV file before importing large contact lists.

Troubleshooting

My CSV file cannot be uploaded

Ensure the file is in CSV format, does not exceed 5 MB, and contains no more than 50,000 records.

Some contacts were not imported

Verify that every Contact-No contains a valid 10-digit Indian mobile number.

I cannot find my Contact Group

Create a Contact Group before importing contacts or adding recipients manually.

My API connection is not working

Verify the Request URL, request method, parameters, and ensure the API returns contact numbers in the expected format.


Frequently Asked Questions

Can I import contacts from Excel?

Export your spreadsheet as a CSV file before importing it into SPRL.

How many contacts can I import at once?

You can import up to 50,000 contacts in a single CSV file.

Can I personalise SMS messages using imported data?

Yes. Contact Groups can store personalization fields such as names, email addresses, locations, and custom fields for use in supported SMS templates.

Can I reuse Contact Groups for future campaigns?

Yes. Contact Groups are designed to be reused across multiple SMS campaigns.


Learn More:
Continue with Transactional vs Promotional SMS to understand the differences between SMS categories, when each should be used, and the applicable DLT requirements.
Tip: Organise contacts into separate groups such as Customers, Leads, Members, or Event Attendees. Well-structured Contact Groups make future campaigns faster to create and easier to manage.

Need more help?

Our support team is always happy to assist you.

×

We use cookies to improve your experience, analyse traffic, and personalise content. By clicking “Accept”, you consent to the use of cookies as described in our Cookie Policy .

Accept cookies Read our Cookie Policy