Bulk SMS & File Formats

Everything you need to upload contacts and send personalized messages via CSV & XLSX formats.

Send SMS through UI

Log In to Dashboard

Sign in to your NestSMS dashboard with your account credentials and open the messaging workspace.

Compose a Message

Go to the send page, enter your sender name, and write the message you want to deliver.

Select Recipients

Add numbers manually, upload a list, or choose a saved group, then review and send.

Bulk SMS File Format Guide

Supported Formats

FormatExtensions
CSV (Comma-Separated Values).csv
Excel Workbook.xlsx, .xls

Required Column: Phone Number

Your file must contain a phone number column. The header can be any of the following (case-insensitive):

  • phone
  • phone_number
  • mobile
  • mobile_number
  • cell
  • cell_number
  • telephone
  • contact
  • contact_number
  • number
  • recipient_phone
  • recipient_number
  • to

Valid Phone Number Formats

All numbers must be Nepali mobile numbers (10 digits starting with 98 or 97).

Input FormatAccepted?
9841234567✓ Yes
+9779841234567 — prefix stripped automatically✓ Yes
9779841234567 — prefix stripped automatically✓ Yes
01-123456 (landline)✗ Skipped
984123 (too short)✗ Skipped

Optional Column: Name

If a name column is present, it is attached to each message as the recipient name. Any of these headers are accepted:

  • name
  • full_name
  • first_name
  • recipient_name
  • customer_name
  • contact_name

Template Variables

Any column in your file can be used as a placeholder in your message template using {columnName} or {{columnName}} syntax.

Column headers are lowercased and spaces replaced with underscores. So First Name → {first_name}.

Common Aliases

Template VariableAlso Resolved From
{name}first_name, full_name, firstname, fullname
{firstname}first_name
{lastname}last_name
{fullname}full_name, name, first_name
{phone}phone_number, mobile, mobile_number, contact_number
{mobile}mobile_number, phone, phone_number
{email}email_address

Examples

1. Simple — No Variables

Every recipient gets the same message.

File:

phone
9841234567
9867654321