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.
- Navigate to Dashboard → Contacts → Contact Groups.
- Click New Contact Group.
- Enter the Group Name.
- Select the personalization fields you want to store.
- Add any remarks if required.
- 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
- Click Import Contacts.
- Select the Contact Group.
- Choose your CSV file.
- Click Upload Contact.
- 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.
- Click Add Contacts.
- Select the Contact Group.
- Enter one or more mobile numbers separated by commas.
- 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.