Are there free trial credits or sandbox keys available for developer testing in India?

Yes. When you register for an SMSINDIAHUB developer account, you receive 100 free test credits and instant access to our sandbox API environment. Developers can test REST endpoints, authentication keys, webhook callbacks, and delivery receipts (DLR) with zero upfront costs and no credit card required.

How do I create and integrate the SMS Gateway API into my website or application?

Integrating our SMS Gateway API takes less than 5 minutes using standard HTTP GET, POST, or JSON REST endpoints. Simply pass your API Key, approved DLT Sender ID, recipient phone number, Entity ID, Template ID, and message body. Copy-ready code snippets are available for PHP, Python, Java, Node.js, C#, and cURL.

Which programming languages, SDKs, and API protocols are supported?

Our platform natively supports RESTful JSON APIs, HTTP GET/POST URLs, and SMPP v3.4 server binds for high-volume enterprise traffic. Pre-built integration scripts and sample payloads are provided for PHP (cURL), Python (requests), Node.js (Axios), Java (OkHttp), and .NET / C#.

How does the SMS API handle TRAI DLT Principal Entity, Sender ID, and Template validation?

In accordance with TRAI regulations, all commercial SMS in India requires an approved Principal Entity ID (PE-ID), 6-character Sender ID (Header), and registered 19-digit Content Template ID. You can pass PEId and TemplateId as parameters in your API request; our gateway automatically validates tokens before routing to prevent message drops.

What are the throughput limits, delivery latency, and uptime SLA guarantees?

SMSINDIAHUB's carrier-grade SMS gateway handles up to 8,000 messages per second with dedicated multi-operator failover routing across Jio, Airtel, and Vi. The platform provides an average delivery latency under 5 seconds for critical OTPs and transactional alerts, backed by a guaranteed 99.95% platform SLA.

HTTP / HTTPS / SMPP REST API GET & POST Supported Free Test Credits Included

Free SMS Gateway Developer API in India

Integrate the leading free SMS gateway developer API of India by SMSINDIAHUB. Use our best-in-class RESTful API to connect your software, mobile application, eCommerce store, ERP, and IoT hardware with instant carrier routing.

Send unlimited SMS via HTTP, HTTPS, and SMPP APIs suitable for both low-throughput notifications and high-throughput enterprise pipelines with guaranteed sub-5-second latency.

Get Free API Key with Free Credits → Explore Endpoints & Code Samples ↓

REST API Specifications

SMS API Endpoints With Live Request Formats

Select an API method below to inspect endpoint URLs, required parameters, and sample JSON responses.

Endpoint 01

Single SMS API (Promotional & Transactional & API key)

Promotional SMS – Single Message GET URL:

https://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=abc&password=xyz&msisdn=919898xxxxxx&sid=SenderId&msg=test%20message&fl=0

Transactional SMS – Single Message GET URL (with gwid=2):

https://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=abc&password=xyz&msisdn=919898xxxxxx&sid=SenderId&msg=test%20message&fl=0&gwid=2

API –Instead of the username and password you can use the API key for authentication of account

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=apikey&senderid=ABABAB&channel=Trans&DCS=0&flashsms=0&number=910xxxxxxx&text=IDSIHUB

Parameters Reference:

• user: Your SIH login username.

• password: Your SIH login password or API Key.

• msisdn: Destination mobile number (10 digits or with 91 prefix).

• sid: Approved 6-character alphabetic Sender ID.

• msg: Message content (URL encoded). Note: If using templates, fill approved dynamic fields.

• fl: 1 for Flash message, 0 for standard SMS.

• gwid: Set to 2 for Transactional / DND delivery route.

• API Key: you will find your API Key in your SMS account.

Expected JSON Response:

{"ErrorCode":"000","ErrorMessage":"Success","JobId":"381a8090-b230-42fa-ac04-157cc2142bfa","MessageData":[{"MobileNumber":"919898xxxxxx","MessageParts":[{"MessageId":"919898xxxxxx-67e3765cdf034f438a432eacb88d0c14","MessagePartId":1,"MessageText":"test message"}]}]}

Endpoint 02

Multiple SMS API (Comma Separated Numbers)

Multiple SMS via Username & Password:

https://cloud.smsindiahub.in/api/mt/SendSMS?user=demo&password=demo123&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx,91999xxxxxxx&text=test message&DLTTemplateId=##&route=##&PEId=##

Multiple SMS via API Key:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=123456789&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx,91999xxxxxxx&text=test message&route=##&PEId=##

Note: Only 100 mobile numbers are allowed. (pass with comma separated).

Batch JSON Response:

{"ErrorCode":"000","ErrorMessage":"Done","JobId":"20047","MessageData":[{"Number":"91989xxxxxxx","MessageId":"mvHdpSyS7UOs9hjxixQLvw"},{"Number":"91999xxxxxxx","MessageId":"PfivClgH20iG6G5R3usHwA"}]}

Endpoint 03

Send SMS Tiny (Link Shortener & Click Tracking)

Request URL:

https://cloud.smsindiahub.in/api/mt/SendSmsTiny?user=demo&password=demo123&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&route=##&PEId=##&&IsConvertLinkToTiny=""

Response JSON:

{"ErrorCode":"000","ErrorMessage":"Done","JobId":"20047","MessageData":[{"Number":"91989xxxxxxx","MessageId":"mvHdpSyS7UOs9hjxixQLvw"},{"Number":"917405080952","MessageId":"PfivClgH20iG6G5R3usHwA","IsConvertLinkToTiny":""}]}

Endpoint 04

Schedule SMS API

Schedule SMS via Username & Password:

https://cloud.smsindiahub.in/api/mt/SendSMS?user=demo&password=demo123&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&schedtime=2015/12/31 22:35:00 PM&route=##

Schedule SMS via API Key:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=123456789&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&schedtime=2015/12/31 22:35:00 PM&route=##

* Note: The schedtime format is yyyy/mm/dd hh:mm:ss PM (e.g. 2015/12/31 22:35:00 PM).

Response JSON:

{"ErrorCode":"000","ErrorMessage":"Done","JobId":"20047","MessageData":[{"Number":"91989xxxxxxx","MessageId":"BqTiw66A2UGLFV3DnwHFLQ"}]}

Endpoint 05

Group SMS API

Group SMS via Username & Password:

https://cloud.smsindiahub.in/api/mt/SendSMS?user=demo&password=demo123&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&groupid=###&route=##

Group SMS via API Key:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=123456789&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&groupid=###&route=##

Response JSON:

{"ErrorCode":"000","ErrorMessage":"Done","JobId":"20047","MessageData":[{"Number":"91989xxxxxxx","MessageId":"mvHdpSyS7UOs9hjxixQLvw"},{"Number":"91999xxxxxxx","MessageId":"PfivClgH20iG6G5R3usHwA"}]}

Endpoint 06

Sign Up API

https://cloud.smsindiahub.in/api/auth/signup?username=demo&password=demo123&mobile=911441231231&emailid=demo@gmail.com

Response:

Success#user created successfully.

Endpoint 07

Check Balance API

Check Balance GET URL:

https://cloud.smsindiahub.in/api/mt/GetBalance?User=demo&Password=demo123

Response JSON:

{"ErrorCode":"0","ErrorMessage":"Done","Balance":"Promo:9988|Trans:0"}

Endpoint 08

Check Delivery API

Check Delivery GET URL:

https://cloud.smsindiahub.in/api/mt/GetDelivery?user=demo&password=demo123&jobid=#######

Response JSON:

{"ErrorCode":"0","ErrorMessage":"Done","MessageId":null,"DeliveryReports":[{"MessageId":"mvHdpSyS7UOs9hjxixQLvw","DeliveryStatus":"Delivered","DeliveryDate":"2015-09-28T06:17:00"},{"MessageId":"PfivClgH20iG6G5R3usHwA","DeliveryStatus":"Delivered","DeliveryDate":"2015-09-28T06:17:00"}]}

Endpoint 09

Check Sent Report API

Sent Report GET URL (Date Range):

https://cloud.smsindiahub.in/api/mt/GetSentReport?user=demo&password=demo&fromdate=2017-12-04&todate=2017-12-05

* Note: Parameters fromdate and todate accept yyyy-mm-dd or yyyy/mm/dd formats.

Endpoint 10

2Factor Authentication API Specification (v1.0)

The 2 Factor Authentication API is a RESTful API for adding strong two-factor authentication to your website or application.

First Step:

1. Signup for a 2FA Account.

2. Login to Admin Panel and Click on API Key to get your Key.

1. Send Auto Generated SMS OTP:

https://2factorauthentication.in/auth/api/send_otp/api_key/{API_KEY}/mobile/{MOBILE}/mail/{EMAIL}

Example:

https://2factorauthentication.in/auth/api/send_otp/api_key/abcdefgh123456789/mobile/1234567890/mail/test@gmail.com

Success Response:

{"code":"E801", " message ":"OTP Sent Successfully","status ":"success", "otp_id":"123456"}

Failed Response:

{"code":"E803", " message ":" API Key didn't receive in request headers","status ":"failed"}

2. Verify SMS OTP Input:

https://2factorauthentication.in/auth/api/verify_otp/api_key/{API_KEY}/otp_id/{OTP_ID}/otp/{OTP}

Example:

https://2factorauthentication.in/auth/api/verify_otp/api_key/abcdefgh123456789/otp_id/789012/otp/123456

Success Response:

{"code":"E901", " message ":"OTP Verified Successfully","status ":"success"}

Failed Response:

{"code":"E803", " message ":" API Key didn't receive in request headers","status ":"failed"}

Status & Error Codes Reference:

Send OTP Codes:

'E801': OTP Sent Successfully

'E803': API Key didn't receive in request headers

'E804': Invalid API Key

'E805': Customer has been deactivated

'E806': SMS service is not active

'E807': cURL Error

'E808': Insufficient SMS Balance

'E809': Something Went Wrong.

'E810': SMS API’s User ID is required

'E811': SMS API’s key is required

'E812': SMS API's Password is required

'E813': SMS SID is required

'E814': Recipient is required

'E815': Invalid Customer ID

Verify OTP Codes:

'E901': OTP Verified Successfully

'E902': Invalid API Key or OTP ID

'E903': API Key didn't receive in request headers

'E904': OTP ID is required

'E905': OTP is required

'E906': OTP is expired

'E907': Something Went Wrong. Internal Error

'E908': OTP Verification Failed

'E909': Something Went Wrong. Internal Error

'E910': OTP Already Expired

Endpoint 11

XML API POST Specification

Post Data to:

https://cloud.smsindiahub.in/api/mt/SendSMS?

Single & Multiple SMS XML Payload Structure:

<?xml version="1.0" encoding="utf-8" ?>
<SMS>
  <Account>
    <User>demo</User>
    <Password>demo123</Password>
    <!-- Or <APIKey>123456789</APIKey> -->
    <SenderId>WEBSMS</SenderId>
    <Channel>Promo</Channel>
    <DCS>0</DCS>
    <FlashSMS>0</FlashSMS>
    <Route>##</Route>
    <PEId>##</PEId>
  </Account>
  <Messages>
    <Message>
      <Number>91989xxxxxxx</Number>
      <Text>test message</Text>
      <DLTTemplateId>##</DLTTemplateId>
    </Message>
    <Message>
      <Number>91999xxxxxxx</Number>
      <Text>test message 2</Text>
      <DLTTemplateId>##</DLTTemplateId>
    </Message>
  </Messages>
</SMS>

Reference Guide

Parameter Information

Parameter Name	Group	Description
user	Account	Your login username
password	Account	Your login password
APIKey	Account	Instead of the username and password you can use the api key for authentication of account
senderid	Message	Approved sender id (6 characters string only).
channel	Message	Message channel promotional or transactional
route	Message	Pass the route id in this parameter to route the message. Click Here for more information regarding your routeid.
DCS	Message	Data coding value (Default is 0 for normal message, Set 8 for unicode sms)
flashsms	Message	Flash message immediate display (Default is 0 for normal sms, Set 1 for immediate display)
number	Message	Recipient mobile number (pass with comma seprated if need to send on more then one number)
text	Message	Your sms content
schedtime	Optional	Schedule date and time for scheduling message (DateTime formate will be 2014/10/06 20:30:00 PM yyyy/mm/dd hh:mm:ss PM)
groupid	Optional	group id for numbers. (Note: Only 100 mobile numbers are allowed).

System Error Codes

API Error Code Reference (000 - 036)

When making HTTP requests to SMSINDIAHUB endpoints, inspect the ErrorCode parameter in the JSON response against the standardized status codes below:

Error Code	Description / Status
000	Done
001	login details cannot be blank
003	sender cannot be blank
004	message text cannot be blank
005	message data cannot be blank
006	error: generic error description
007	username or password is invalid
008	account not active
009	account locked, contact your account manager
010	api restriction
011	ip address restriction
012	invalid length of message text
013	mobile numbers not valid
014	account locked due to spam message contact support
015	senderid not valid
017	groupid not valid
018	multi message to group is not supported
019	schedule date is not valid
020	message or mobile number cannot be blank
021	insufficient credits
022	invalid jobid
023	parameter missing
024	invalid template or template mismatch
025	{Field} can not be blank or empty
026	invalid date range
027	invalid optin user
028	Invalid Data
029	Email can not be blank
030	Password can not be blank
031	Username can not be blank
032	Mobile number can not be blank
033	UserName already exist
034	Mobile number already exist
035	EmailId already exist
036	EmailId can not be blank

Endpoint 15

Unicode Regional SMS API (DCS=8)

Hindi / Regional Languages GET URL:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=apikey&senderid=ABABAB&channel=Trans&DCS=8&flashsms=0&number=919898xxxxxx&text=%E0%A4%86%E0%A4%AA%E0%A4%95%E0%A4%BE%20OTP%205421%20%E0%A4%B9%E0%A5%88

* Note: Set DCS=8 for UTF-8 / Unicode characters. Each 70-character count constitutes 1 SMS credit for Unicode messages.

Endpoint 16

Automated Voice Call OTP API

Voice Broadcast GET Request:

https://cloud.smsindiahub.in/voice/api/send_otp.aspx?user=abc&password=xyz&number=919898xxxxxx&otp=4592&lang=en

Endpoint 17

2-Way Virtual Mobile Long Code API

Inbound Webhook Forwarding URL:

https://yourdomain.com/sms-receiver.php?sender=919898xxxxxx&keyword=TRACK&message=TRACK%2012345&timestamp=1700000000

Endpoint 18

5-Digit Dedicated Short Code Webhook

Short Code Dispatch Callback:

https://yourdomain.com/shortcode-listener.php?shortcode=56767&sender=919898xxxxxx&keyword=SIH&text=SIH%20DEMO

Endpoint 19

Global International SMS Gateway API

International HTTP Endpoint:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=apikey&senderid=GLOBAL&channel=Trans&DCS=0&flashsms=0&number=14155552671&text=Welcome%20to%20Global%20Portal

Integration SDKs & Scripts

SMS API With Ready-To-Use Sample Code

Copy and paste verified code snippets into your application in PHP, ASP, C#, VB.NET, or Java.

PHP 7.4+ / PHP 8+ cURL Implementation

<?php
// SMSINDIAHUB Free SMS Gateway API Integration (PHP cURL)
$user     = "your_username";
$password = "your_password_or_apikey";
$msisdn   = "9198XXXXXXXX";       // Destination Mobile Number
$sid      = "SMSHUB";             // 6-Character Approved Sender ID
$msg      = urlencode("Dear User, your verification code is 6547. Valid for 10 mins.");
$fl       = "0";                  // 0 = Normal SMS, 1 = Flash SMS
$gwid     = "2";                  // 2 = Transactional / DND Route

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user={$user}&password={$password}&msisdn={$msisdn}&sid={$sid}&msg={$msg}&fl={$fl}&gwid={$gwid}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

C# (.NET Core / ASP.NET)

using System;
using System.IO;
using System.Net;
using System.Text;

class SMSIndiaHubSender
{
    static void Main()
    {
        string user = "YOUR_USERNAME";
        string password = "YOUR_PASSWORD";
        string mobile = "9198XXXXXXXX";
        string senderId = "WEBSMS";
        string message = Uri.EscapeDataString("Hi, Thanks for signing up with SMSINDIAHUB.");
        
        string url = $"http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user={user}&password={password}&msisdn={mobile}&sid={senderId}&msg={message}&fl=0&gwid=2";
        
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "GET";
        
        using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
        using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
        {
            string result = reader.ReadToEnd();
            Console.WriteLine(result);
        }
    }
}

VB.NET Implementation

Imports System.IO
Imports System.Net

Public Class SMSBroadcast
    Public Sub SendSMS()
        Dim sURL As String = "http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=YourUser&password=YourPass&msisdn=9198XXXXXXXX&sid=WEBSMS&msg=Test%20SMS&fl=0&gwid=2"
        Dim request As WebRequest = WebRequest.Create(sURL)
        Using response As WebResponse = request.GetResponse()
            Using stream As Stream = response.GetResponseStream()
                Using reader As New StreamReader(stream)
                    Dim result As String = reader.ReadToEnd()
                    Console.WriteLine(result)
                End Using
            End Using
        End Using
    End Sub
End Class

Java Standard HTTP Connection

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;

public class SMSIndiaHubClient {
    public static void main(String[] args) {
        try {
            String user = "username";
            String password = "password";
            String msisdn = "9198XXXXXXXX";
            String sid = "WEBSMS";
            String msg = URLEncoder.encode("Your verification OTP is: 123456", "UTF-8");

            String endpoint = "http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=" + user 
                + "&password=" + password + "&msisdn=" + msisdn + "&sid=" + sid + "&msg=" + msg + "&fl=0&gwid=2";

            URL url = new URL(endpoint);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");

            BufferedReader rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            StringBuilder response = new StringBuilder();
            String line;
            while ((line = rd.readLine()) != null) {
                response.append(line);
            }
            rd.close();
            System.out.println("Response: " + response.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Classic ASP (VBScript Msxml2.ServerXMLHTTP)

<%
Dim sUser, sPassword, sNumber, sMessage, sSenderID, sURL, objXmlHttpMain
sUser = "username"
sPassword = "password"
sNumber = "9198XXXXXXXX"
sMessage = "Test SMS from SMS INDIA HUB"
sSenderID = "WEBSMS"

sURL = "http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=" & sUser & "&password=" & sPassword & "&msisdn=" & sNumber & "&sid=" & sSenderID & "&msg=" & Server.URLEncode(sMessage) & "&fl=0&gwid=2"

Set objXmlHttpMain = Server.CreateObject("Msxml2.ServerXMLHTTP")
objXmlHttpMain.open "GET", sURL, False
objXmlHttpMain.send
Response.Write(objXmlHttpMain.responseText)
Set objXmlHttpMain = Nothing
%>

Integration Tutorial

How to integrate bulk SMS API in PHP?

To integrate Bulk SMS in PHP, first create an account with SMSINDIAHUB to generate your API Key and sender ID. Next, initialize a PHP cURL session, pass the target mobile number and approved DLT template content in URL-encoded format, and execute the request for instant delivery of OTP SMS and transactional alerts.

Explore Developer API Playground →

Business Advantages

Why SMS API integration?

SMS API integration is the process required to integrate SMS services with websites, software, mobile applications, and billing portals. It provides the fastest, most reliable method to send automated transactional notifications, 2FA security tokens, payment confirmations, and customer alerts via our carrier-grade bulk SMS gateway.

Get Free Test Account →

Full CPaaS Stack

Supported SMS Gateway Developer APIs

✔ Send SMS API

✔ Balance Check API

✔ Unicode SMS API

✔ Single SMS API

✔ Multiple SMS API

✔ Delivery Check API

✔ 2FA Auth API

✔ Long Code API

✔ Short Code API

✔ Voice Call OTP API

✔ XML API

✔ International SMS API

Frequently Asked Questions

Developer SMS API Questions & Answers

Everything you need to know about free developer sandbox credits, API protocols, DLT compliance, and latency benchmarks.

READY TO CONNECT YOUR APP?

Start Building with Free SMS Gateway API Today

Create your free developer sandbox account, claim 100 free testing credits, and send your first test SMS in under 5 minutes with full DLT support.

Instant API & DLT Activation

99.95% Guaranteed SLA

Free Demo

24/7 Dedicated Support

Get Free API Key Start Free Sandbox +91 8305781001

Get in Touch With Us

Quick setup • Free trial credits • Dedicated manager

Free SMS Gateway Developer API in India

SMS API Endpoints With Live Request Formats

Single SMS API (Promotional & Transactional & API key)

Multiple SMS API (Comma Separated Numbers)

Send SMS Tiny (Link Shortener & Click Tracking)

Schedule SMS API

Group SMS API

Sign Up API

Check Balance API

Check Delivery API

Check Sent Report API

2Factor Authentication API Specification (v1.0)

XML API POST Specification

SMPP Server Interconnect (v3.4)

Parameter Information

API Error Code Reference (000 - 036)

Unicode Regional SMS API (DCS=8)

Automated Voice Call OTP API

2-Way Virtual Mobile Long Code API

5-Digit Dedicated Short Code Webhook

Global International SMS Gateway API

SMS API With Ready-To-Use Sample Code

How to integrate bulk SMS API in PHP?

Why SMS API integration?

Supported SMS Gateway Developer APIs

Developer SMS API Questions & Answers

Are there free trial credits or sandbox keys available for developer testing in India?

How do I create and integrate the SMS Gateway API into my website or application?

Which programming languages, SDKs, and API protocols are supported?

How does the SMS API handle TRAI DLT Principal Entity, Sender ID, and Template validation?

What are the throughput limits, delivery latency, and uptime SLA guarantees?

Start Building with Free SMS Gateway API Today