SMS

SMS API

Overview

This document explains how SMS and DLT-based messaging work in India, and how those concepts map to the Surepass SMS APIs and console pages.

DLT Basics

In India, all promotional and transactional SMS traffic must be registered on DLT (Distributed Ledger Technology) platforms operated by telecom operators. DLT is a regulatory framework that:

Tracks every SMS sender and template to prevent spam.

Ensures consent and content compliance with TRAI regulations.

Requires pre-approval of sender identities and message content.

To send SMS through Surepass, you must already have DLT registration with your operator (e.g. Vodafone, Jio, Airtel, Smartping) and provide us with the required identifiers.

PE ID (Principal Entity ID)

Unique ID for your business on the DLT platform; all headers and templates are mapped to it and it is attached to every SMS request.

Header (Sender ID)

Alphanumeric sender name shown as the "from" (e.g. SUREPS), registered on DLT against your PE ID and referenced as Sender ID when creating templates.

SMS Templates (DLT Templates)

What they are: Pre-approved message bodies registered on the DLT portal.

Template ID: Each approved template gets a Template ID (sometimes called Content Template ID) from the operator. This ID must be passed in every SMS request.

Fixed vs variable parts:

The fixed part of the text must match exactly with what’s registered on DLT.

Variable parts (e.g. OTP, name, amount) are represented as placeholders, such as {} in the raw text or {var1}, {var2} in the console UI.

How templates are used in the console:

You save the DLT template in the Templates screen with its Template ID, Sender ID and message body.

When sending SMS from the dashboard or APIs, we merge your runtime variables into these placeholders and attach the correct Template ID and header to the request sent to the operator.

Example

PE ID: 1102000000001234567

Header / Sender ID: SUREPS

Template ID: 1107162325427845021

Template text registered on DLT:
Dear customer, your OTP for login is {#var#}. It is valid for 10 minutes.

Template variable mapping when sending:

var1 = "482913"

SMS Dashboard Overview

The SMS section of the Surepass console provides a complete UI to monitor and manage your SMS traffic on top of the DLT configuration you already have with operators.

The main entry points are:

Home - high-level stats and recent SMS activity.

Templates - manage DLT-mapped SMS templates.

Logs - search and inspect individual SMS deliveries.

Bulk - upload and monitor bulk SMS campaigns.

Home – SMS Overview

URL: https://console.surepass.app/product/sms/home

The Home page gives you a top-level picture of your SMS usage and health.

Key stats

Total messages sent in a selected time range.

Breakup by status (delivered, failed, pending, etc.).

Basic error / failure distribution to quickly spot issues.

Recent SMS logs

A compact table of the most recent messages.

Quick view of template, recipient, status and timestamp.

Shortcuts to drill down into the full Logs view for deeper debugging.

SMS home - stats and recent logs:

Templates – Manage SMS Templates

URL: https://console.surepass.app/product/sms/templates

The Templates page mirrors your DLT setup and is where you manage the templates that can be used by your applications.

Template listing

Shows each template’s Template ID, Sender ID (Header), number of variables, created-at timestamp, and the full message body with variable placeholders.

Create / edit templates

Add a new template by providing:

Template ID from DLT.

Sender ID / header.

Exact message text with placeholders.

Edit existing templates when your DLT content changes and you need to sync the new body.

Send test SMS from template

From each row you can open a Send SMS dialog.

Enter a mobile number and variable values to preview the final text and send a test message.

SMS templates:

Add new template dialog:

Send SMS from template dialog:

Logs - Search SMS Activity

URL: https://console.surepass.app/product/sms/logs

The Logs page contains a detailed record of every SMS processed through Surepass.

Filtering and search

Filter by date range, mobile number, Template ID, Sender ID and status.

Quickly locate a specific message when debugging customer issues.

Per-message details

Request and response metadata from downstream providers where available.

Final delivery status and error codes.

Template information and the full message body, enabling you to troubleshoot delivery issues, validate delivery, and respond to support queries (for example, "Did this user receive the SMS?").

SMS logs:

SMS log details:

Bulk - Manage Bulk Campaigns

URL: https://console.surepass.app/product/sms/bulk

The Bulk page helps you run one-to-many SMS campaigns.

Campaign creation

Upload or select a list of recipients.

Choose an approved template and map columns to template variables.

Use the sample CSV format for new uploads: sms-bulk-sample.csv.
The CSV must follow this format:

mobile	template_id	var1	var2
9999999999	1107740006247153170	123456	10 minutes
8989999999	1107740006247153170	654321	10 minutes

mobile: recipient mobile number (10 digits).

template_id: DLT Template ID to use for the message.

var1, var2, ..., varN: values that will be substituted into the template placeholders. You can add as many varX columns as your template requires (for example, var1, var2, ..., var10, var11, etc.).

Campaign monitoring

Track campaign-level statistics: total messages, delivered, failed, in-progress.

View batch-level and message-level logs by drilling down into a campaign.

Ideal for marketing blasts, notifications to large cohorts, and recurring operational SMS (e.g. monthly reminders) where you want visibility at both campaign and per-message level.

Bulk SMS: