SMS API documentation

curl -X POST https://cloudsms.in/api/v1/sms/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "1207168xxxxxxxx412",
    "variables": ["Ravi", "482913"],
    "to": ["9876543210", "9123456780"]
  }'

$ch = curl_init('https://cloudsms.in/api/v1/sms/send');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'template_id' => '1207168xxxxxxxx412',
        'variables'   => ['Ravi', '482913'],
        'to'          => ['9876543210', '9123456780'],
    ]),
]);
$result = json_decode(curl_exec($ch), true);

const res = await fetch("https://cloudsms.in/api/v1/sms/send", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_id: "1207168xxxxxxxx412",
    variables: ["Ravi", "482913"],
    to: ["9876543210", "9123456780"],
  }),
});
const result = await res.json();

import requests

r = requests.post(
    "https://cloudsms.in/api/v1/sms/send",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "template_id": "1207168xxxxxxxx412",
        "variables": ["Ravi", "482913"],
        "to": ["9876543210", "9123456780"],
    },
)
print(r.json())

$otp = (string) random_int(100000, 999999);
// Save a hash of $otp with the user's number and an expiry time.

$ch = curl_init('https://cloudsms.in/api/v1/sms/send');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'template_id' => 'YOUR_OTP_TEMPLATE_ID',
        'variables'   => [$otp],
        'to'          => [$mobile],
    ]),
]);
$result = json_decode(curl_exec($ch), true);

import crypto from "node:crypto";

const otp = String(crypto.randomInt(100000, 1000000));
// Save a hash of otp with the user's number and an expiry time.

await fetch("https://cloudsms.in/api/v1/sms/send", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ template_id: "YOUR_OTP_TEMPLATE_ID", variables: [otp], to: [mobile] }),
});

import secrets, requests

otp = str(secrets.randbelow(900000) + 100000)
# Save a hash of otp with the user's number and an expiry time.

requests.post(
    "https://cloudsms.in/api/v1/sms/send",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"template_id": "YOUR_OTP_TEMPLATE_ID", "variables": [otp], "to": [mobile]},
)

$body = file_get_contents('php://input');
$ts   = $_SERVER['HTTP_X_CLOUDSMS_TIMESTAMP'] ?? '';
$sig  = $_SERVER['HTTP_X_CLOUDSMS_SIGNATURE'] ?? '';
$good = 'sha256=' . hash_hmac('sha256', $ts . '.' . $body, 'YOUR_SIGNING_SECRET');

if (!hash_equals($good, $sig) || abs(time() - (int) $ts) > 300) {
    http_response_code(401);
    exit;
}
foreach (json_decode($body, true)['events'] as $event) {
    // update your records with $event['mobile'] and $event['status']
}
http_response_code(200);

import crypto from "node:crypto";
import express from "express";

const app = express();
app.post("/sms-status", express.raw({ type: "application/json" }), (req, res) => {
  const ts = req.get("X-CloudSMS-Timestamp") || "";
  const sig = req.get("X-CloudSMS-Signature") || "";
  const good = "sha256=" + crypto.createHmac("sha256", "YOUR_SIGNING_SECRET")
    .update(ts + "." + req.body).digest("hex");
  if (sig.length !== good.length || !crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(good))) {
    return res.sendStatus(401);
  }
  for (const event of JSON.parse(req.body).events) {
    // update your records
  }
  res.sendStatus(200);
});