{"id":2506,"date":"2026-07-20T12:27:14","date_gmt":"2026-07-20T06:57:14","guid":{"rendered":"https:\/\/www.smsgatewaycenter.com\/blog\/?p=2506"},"modified":"2026-07-20T12:27:17","modified_gmt":"2026-07-20T06:57:17","slug":"send-sms-api-guide","status":"publish","type":"post","link":"https:\/\/www.smsgatewaycenter.com\/blog\/send-sms-api-guide\/","title":{"rendered":"SMS API Guide: Getting Started with Sending SMS Programmatically (2026)"},"content":{"rendered":"\n

An SMS API<\/strong> lets your application send a text message with a single HTTPS request instead of relying on manual entry through a web portal. This guide covers the full path from getting API credentials to receiving a delivery confirmation, using the real request structure, parameters, and response format from SMSGatewayCenter’s Send SMS (Quick) endpoint, plus what changes if your messages are going to Indian mobile numbers and need DLT registration.<\/p>\n\n\n\n

\"Diagram<\/a><\/figure>\n\n\n\n

To send an SMS via API you sign up for an account, generate either a userid\/password pair or an API key, then send a POST request to the gateway’s send endpoint with parameters for the recipient number, message body, sender ID, and message type. The gateway responds with a transaction ID and status you can log and reconcile against delivery reports. If you are sending to Indian numbers for transactional or promotional purposes, you also need an approved DLT entity ID and template ID attached to every request, or the operator will silently drop the message.<\/p>\n\n\n\n

What Is an SMS API<\/h2>\n\n\n\n

An SMS API is a set of HTTP endpoints that a messaging provider exposes so external applications can trigger SMS delivery, check delivery status, manage sender IDs, and handle templates programmatically. Instead of logging into a dashboard and typing a message, your backend code makes a request and the gateway routes it to the correct mobile network operator.<\/p>\n\n\n\n

Search intent for “SMS API” splits into two camps: developers who want to integrate messaging into an app (informational and how-to), and businesses evaluating providers before signing up (commercial). This guide is written for the first group, but the SMS API vs WhatsApp Business API<\/a><\/strong> section below addresses the evaluation angle too.<\/p>\n\n\n\n

How an SMS API Actually Works<\/h2>\n\n\n\n
\"Diagram<\/a><\/figure>\n\n\n\n

A typical request cycle has four stages. Your application constructs an HTTPS POST request with the recipient’s number, message text, and your credentials. The gateway validates the request, checks your account balance and sender ID approval, and queues the message for delivery to the operator network. The operator delivers the SMS to the handset and generates a delivery receipt (DLR), which the gateway either returns synchronously in some cases or pushes to your registered webhook. Your application should log the transaction ID from the initial response so you can match it against the delivery receipt later, since delivery is asynchronous and can take anywhere from under a second to a few minutes depending on operator load.<\/p>\n\n\n\n

Most competing “getting started” guides stop at the initial send call and never explain the DLR loop, which is the part that actually matters in production, because “sent” and “delivered” are two different states and conflating them is the single most common integration mistake teams make in their first month.<\/p>\n\n\n\n

SMS API vs SMPP: Which One Do You Need<\/h2>\n\n\n\n
Factor<\/th>HTTP SMS API<\/th>SMPP<\/th><\/tr><\/thead>
Setup complexity<\/td>Low, standard REST-style calls<\/td>Higher, requires a persistent binding and session management<\/td><\/tr>
Best for<\/td>Web apps, low to medium volume, quick integration<\/td>High-volume senders, telecom-grade throughput needs<\/td><\/tr>
Connection type<\/td>Stateless HTTPS requests<\/td>Stateful TCP socket connection<\/td><\/tr>
Typical use case<\/td>Transactional alerts, OTP, marketing campaigns<\/td>Enterprise platforms sending large volumes continuously<\/td><\/tr>
Learning curve<\/td>Minimal, works with any HTTP client<\/td>Requires understanding of PDU structure and bind types<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

If you are building a web or mobile application and sending under a few hundred thousand messages a day, the HTTP API in this guide is the right starting point. If you are running a telecom-grade platform, see the SMPP connectivity documentation<\/a> instead.<\/p>\n\n\n\n

Getting Your Credentials<\/h2>\n\n\n\n

Sign up for a free account, which gives you a userid and password immediately. From your account dashboard you can also generate a dedicated API key, which is the recommended method for production because it can be regenerated independently of your login password if it leaks. The process for generating and rotating a key is covered in detail in how to create and use your SMS Gateway Center API key<\/a>.<\/p>\n\n\n\n

Authentication Methods<\/h2>\n\n\n\n

There are two ways to authenticate a request to the send endpoint:<\/p>\n\n\n\n

userid and password<\/strong>: pass your registered username and URL-encoded password directly as request parameters. Simple to set up but exposes credentials in the request body on every call.<\/p>\n\n\n\n

apiKey header<\/strong>: generate a unique API key from your control panel and send it as an HTTP header (apikey: YOUR_KEY<\/code>) instead of password but require your userid parameter. This is the safer option for production systems since the key can be revoked and regenerated without touching your account login.<\/p>\n\n\n\n

Use one method or the other, not both. Full parameter-level detail is in the authentication documentation<\/a>.<\/p>\n\n\n\n

\n\n\n\n

Sending Your First SMS: Step by Step<\/h2>\n\n\n\n
    \n
  1. Sign up<\/strong> for an account at the signup page and confirm your registration.<\/li>\n\n\n\n
  2. Get your credentials<\/strong>: note your userid, or generate an apiKey from the dashboard.<\/li>\n\n\n\n
  3. Register a sender ID<\/strong>: a 6-character alphanumeric sender ID needs approval before it will deliver. For India, this ties into DLT (see below).<\/li>\n\n\n\n
  4. Build the request<\/strong>: a POST to the send endpoint with your credentials, recipient number, message, sender ID, and message type.<\/li>\n\n\n\n
  5. Send and check the response<\/strong>: read the status<\/code> and transactionId<\/code> fields, then reconcile against the delivery report endpoint once the DLR arrives.<\/li>\n<\/ol>\n\n\n\n

    The core endpoint for a quick single or batch send is:<\/p>\n\n\n\n

    POST https:\/\/unify.smsgateway.center\/SMSApi\/send\n<\/code><\/pre>\n\n\n\n
    Request Parameters Reference<\/h2>\n\n\n\n
    Parameter<\/th>Required<\/th>Example<\/th>Description<\/th><\/tr><\/thead>
    userid<\/td>Yes, require for using apiKey header or password<\/td>YourUsername<\/td>Registered username<\/td><\/tr>
    password<\/td>Yes, unless using apiKey header<\/td>YourPassword<\/td>URL-encoded password<\/td><\/tr>
    apikey<\/td>Alternative to password<\/td>XXXXXXXXXXXXXXXXXXXX<\/td>Sent as an HTTP header, not a body parameter<\/td><\/tr>
    sendMethod<\/td>Yes<\/td>quick<\/td>Must be set to quick<\/code> for a batch\/single send<\/td><\/tr>
    mobile<\/td>Yes<\/td>919999999999<\/td>Recipient number with country code<\/td><\/tr>
    msg<\/td>Yes<\/td>Hello World<\/td>Message content<\/td><\/tr>
    senderid<\/td>Yes<\/td>SENDER<\/td>Your approved sender ID<\/td><\/tr>
    msgType<\/td>Yes<\/td>text or unicode<\/td>text<\/code> for English, unicode<\/code> for regional-language content<\/td><\/tr>
    output<\/td>No<\/td>plain or json<\/td>Response format, defaults to plain<\/td><\/tr>
    duplicatecheck<\/td>No<\/td>true or false<\/td>Removes duplicate numbers, defaults to true<\/td><\/tr>
    scheduleTime<\/td>No<\/td>2026-08-01 09:00:00<\/td>Format YYYY-MM-DD HH:MM:SS for scheduled sends<\/td><\/tr>
    trackLink<\/td>No<\/td>true or false<\/td>Enables link click tracking inside the message<\/td><\/tr>
    dltEntityId<\/td>Required for India<\/td>numeric ID<\/td>Your DLT-registered Principal Entity ID<\/td><\/tr>
    dltTemplateId<\/td>Required for India<\/td>numeric ID<\/td>Your DLT-approved content template ID<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    Reading the Response and Handling Errors<\/h2>\n\n\n\n
    A successful call to the send endpoint returns JSON like this:<\/p>\n\n\n\n
    {\n  \"status\": \"success\",\n  \"mobile\": \"919999999999\",\n  \"invalidMobile\": \"\",\n  \"transactionId\": \"6305583318236810379\",\n  \"statusCode\": \"200\",\n  \"reason\": \"success\"\n}\n<\/code><\/pre>\n\n\n\n
    Store transactionId<\/code> against your internal message record. It is the key you will use to query the delivery report endpoint<\/a> later and confirm whether the message actually reached the handset, not just whether the gateway accepted it.<\/p>\n\n\n\n
    If a request fails, the gateway returns a numeric error code you can map using the API error code list<\/a> endpoint, which returns a full JSON list of every possible error and HTTP status pairing. Delivery-side failures (as opposed to request-side rejections) use a separate set of codes documented at the delivery error code list endpoint, since a message can be accepted by the API and still fail at the operator level for reasons like an invalid or DND-registered number.<\/p>\n\n\n\n
    Code Samples<\/h2>\n\n\n\n
    cURL<\/h3>\n\n\n\n
    curl --location --request POST 'https:\/\/unify.smsgateway.center\/SMSApi\/send' \\\n--header 'apikey: XXXXXXXXXXXXXXXXXXXX' \\\n--header 'content-type: application\/x-www-form-urlencoded' \\\n--data-urlencode 'sendMethod=quick' \\\n--data-urlencode 'mobile=919999999999' \\\n--data-urlencode 'msg=Hello World' \\\n--data-urlencode 'senderid=SENDER' \\\n--data-urlencode 'msgType=text' \\\n--data-urlencode 'duplicatecheck=true' \\\n--data-urlencode 'output=json'\n<\/code><\/pre>\n\n\n\n
    PHP<\/h3>\n\n\n\n
    <?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n  CURLOPT_URL => \"https:\/\/unify.smsgateway.center\/SMSApi\/send\",\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => \"\",\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 30,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => \"POST\",\n  CURLOPT_POSTFIELDS => \"sendMethod=quick&mobile=919999999999&msg=Hello+World&senderid=SENDER&msgType=text&duplicatecheck=true&output=json\",\n  CURLOPT_HTTPHEADER => array(\n    \"apikey: XXXXXXXXXXXXXXXXXXXX\",\n    \"cache-control: no-cache\",\n    \"content-type: application\/x-www-form-urlencoded\"\n  ),\n));\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\ncurl_close($curl);\n\nif ($err) {\n  echo \"cURL Error #:\" . $err;\n} else {\n  echo $response;\n}\n<\/code><\/pre>\n\n\n\n
    Node.js<\/h3>\n\n\n\n
    const axios = require('axios');\nconst qs = require('qs');\n\nconst data = qs.stringify({\n  sendMethod: 'quick',\n  mobile: '919999999999',\n  msg: 'Hello World',\n  senderid: 'SENDER',\n  msgType: 'text',\n  duplicatecheck: 'true',\n  output: 'json'\n});\n\naxios({\n  method: 'post',\n  url: 'https:\/\/unify.smsgateway.center\/SMSApi\/send',\n  headers: {\n    'apikey': 'XXXXXXXXXXXXXXXXXXXX',\n    'content-type': 'application\/x-www-form-urlencoded'\n  },\n  data: data\n})\n.then((response) => console.log(response.data))\n.catch((error) => console.error(error));\n<\/code><\/pre>\n\n\n\n
    Python<\/h3>\n\n\n\n
    import requests\n\nurl = \"https:\/\/unify.smsgateway.center\/SMSApi\/send\"\n\npayload = {\n    'sendMethod': 'quick',\n    'mobile': '919999999999',\n    'msg': 'Hello World',\n    'senderid': 'SENDER',\n    'msgType': 'text',\n    'duplicatecheck': 'true',\n    'output': 'json'\n}\n\nheaders = {\n    'apikey': 'XXXXXXXXXXXXXXXXXXXX'\n}\n\nresponse = requests.post(url, data=payload, headers=headers)\nprint(response.text)\n<\/code><\/pre>\n\n\n\n
    Java<\/h3>\n\n\n\n
    import java.io.*;\nimport java.net.*;\n\npublic class SendSms {\n    public static void main(String[] args) throws Exception {\n        String data = \"sendMethod=quick&mobile=919999999999&msg=\" + URLEncoder.encode(\"Hello World\", \"UTF-8\")\n                + \"&senderid=SENDER&msgType=text&duplicatecheck=true&output=json\";\n\n        URL url = new URL(\"https:\/\/unify.smsgateway.center\/SMSApi\/send\");\n        HttpURLConnection conn = (HttpURLConnection) url.openConnection();\n        conn.setRequestMethod(\"POST\");\n        conn.setRequestProperty(\"apikey\", \"XXXXXXXXXXXXXXXXXXXX\");\n        conn.setRequestProperty(\"Content-Type\", \"application\/x-www-form-urlencoded\");\n        conn.setDoOutput(true);\n\n        try (OutputStream os = conn.getOutputStream()) {\n            os.write(data.getBytes(\"UTF-8\"));\n        }\n\n        BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));\n        String line;\n        StringBuilder response = new StringBuilder();\n        while ((line = br.readLine()) != null) {\n            response.append(line);\n        }\n        System.out.println(response.toString());\n    }\n}\n<\/code><\/pre>\n\n\n\n
    Postman<\/h3>\n\n\n\n
    Import the ready-made collection from the Download SMS Postman<\/a> page, which comes pre-configured with the send endpoint, headers, and body so you only need to swap in your own credentials and test values.<\/p>\n\n\n\n
    \n\n\n\n
    DLT and India Compliance<\/h2>\n\n\n\n
    If any recipient number is on India’s mobile network, the message must be tied to a DLT-registered Principal Entity and an approved content template, or telecom operators will reject or silently drop it under TRAI regulations, regardless of whether your API call itself succeeds. Two additional parameters, dltEntityId<\/code> and dltTemplateId<\/code>, need to be included in the send request once you have completed registration. The full walkthrough, including PE-TM binding, is covered in the DLT registration guide<\/a>.<\/p>\n\n\n\n
    \"Diagram<\/a><\/figure>\n\n\n\n
    Rate Limits and Throughput<\/h2>\n\n\n\n
    Exact throughput ceilings depend on your account tier and route (transactional, promotional, or OTP), and operators impose their own per-second caps on top of gateway-level limits. As a practical rule, batch your sends through the group or file-upload endpoints rather than looping single sendMethod=quick<\/code> calls in a tight loop, since that pattern is the most common cause of rate-limit errors reported by integrators.<\/p>\n\n\n\n
    Common Mistakes and How to Avoid Them<\/h2>\n\n\n\n
    Sending unicode content with msgType=text<\/code> truncates or garbles regional-language messages, since text mode assumes GSM 7-bit encoding. Treating the initial API response as final delivery confirmation instead of polling or subscribing to delivery receipts leads to false “message sent” assumptions when the actual failure happens at the operator level. Reusing a sender ID across DLT and non-DLT routes, or omitting dltEntityId<\/code>\/dltTemplateId<\/code> on Indian transactional traffic, is the most frequent cause of messages that succeed at the API layer but never reach the handset. If you need message content with line breaks, the escaping rules differ from a standard URL-encoded newline; see how to use newline in SMS message when sending via HTTP SMS API<\/a> for the exact syntax.<\/p>\n\n\n\n
    \n\n\n\n
    SMS API vs WhatsApp Business API: When to Use Each<\/h2>\n\n\n\n
    Factor<\/th>SMS API<\/th>WhatsApp Business API<\/th><\/tr><\/thead>
    Reach<\/td>Works on every phone, no app required<\/td>Requires the recipient to have WhatsApp installed<\/td><\/tr>
    Delivery certainty<\/td>High, network-level delivery<\/td>Depends on recipient’s WhatsApp status and opt-in<\/td><\/tr>
    Rich media<\/td>Plain text and links only<\/td>Images, documents, buttons, carousels<\/td><\/tr>
    Best for<\/td>OTP, critical alerts, universal reach<\/td>Marketing, support conversations, rich engagement<\/td><\/tr>
    Setup complexity<\/td>Low<\/td>Higher, requires template approval and business verification<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    For a full breakdown with pricing and use-case mapping, see the WhatsApp Business API vs SMS API comparison guide<\/a>.<\/p>\n\n\n\n
    Pros and Cons of Starting with the HTTP SMS API<\/h3>\n\n\n\n
    Pros: fast to integrate, works with any language that can make an HTTPS call, no persistent connection to manage, good fit for low-to-medium volume.<\/p>\n\n\n\n
    Cons: less efficient than SMPP at very high throughput, each request carries full HTTP overhead, scheduling and retries need to be built into your own application logic unless you use the schedule and campaign endpoints.<\/p>\n\n\n\n
    \n\n\n\n
    FAQs<\/h2>\n\n\n\n
    Do I need a website to use an SMS API?<\/strong> No. You need a server or backend process that can make outbound HTTPS requests, which can be anything from a mobile app backend to a cron job.<\/p>\n\n\n\n
    Can I send the same message to multiple numbers in one call?<\/strong> Yes, using the group or file-upload send endpoints instead of the quick single-batch call, which accept a list or a file of recipients.<\/p>\n\n\n\n
    What happens if my sender ID isn’t approved yet?<\/strong> The API will reject the request with an error code corresponding to an invalid or unapproved sender ID rather than queueing the message.<\/p>\n\n\n\n
    Is JSON the default response format?<\/strong> No, plain text is the default. Set output=json<\/code> explicitly if your application parses JSON.<\/p>\n\n\n\n
    How do I know if a message was actually delivered, not just accepted?<\/strong> Check the delivery report endpoint using the transactionId<\/code> from your send response, or subscribe to delivery receipt webhooks for real-time updates.<\/p>\n\n\n\n
    Sign up for a free account <\/a><\/strong>and send a test message using your own number within your first session, before wiring the API into production code.<\/p>\n\n\n\n
    \n","protected":false},"excerpt":{"rendered":"
    An SMS API lets your application send a text message with a single HTTPS request instead of relying on manual entry through a web portal. This guide covers the full path from getting API credentials to receiving a delivery confirmation, using the real request structure, parameters, and response format from SMSGatewayCenter’s Send SMS (Quick) endpoint, […]<\/p>\n","protected":false},"author":118,"featured_media":2509,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1992],"tags":[1439,86,188,1993,404,176,481,13,27],"class_list":["post-2506","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-sms-api","tag-api-integration","tag-bulk-sms","tag-bulk-sms-provider","tag-developer-documentation","tag-dlt","tag-otp-sms","tag-sms-api","tag-sms-gateway","tag-sms-gateway-center"],"_links":{"self":[{"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/posts\/2506","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/users\/118"}],"replies":[{"embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/comments?post=2506"}],"version-history":[{"count":0,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/posts\/2506\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/media\/2509"}],"wp:attachment":[{"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/media?parent=2506"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/categories?post=2506"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/tags?post=2506"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}