API Reference

$payload = [
    'sender_id' => 'MyBrand',
    'message'   => 'Flash sale — 30% off today only!',
    'to'        => ['233201234567', '233271234567'],
];
$ch = curl_init('https://bulkiemsg.com/api/v1/sms/send');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer bm_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

r = requests.post(
    "https://bulkiemsg.com/api/v1/sms/send",
    headers={"Authorization": "Bearer bm_live_YOUR_KEY"},
    json={
        "sender_id": "MyBrand",
        "message":   "Flash sale — 30% off today only!",
        "to":        ["233201234567", "233271234567"],
    }
)
print(r.json())

const r = await fetch('https://bulkiemsg.com/api/v1/sms/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer bm_live_YOUR_KEY',
    'Content-Type':  'application/json',
  },
  body: JSON.stringify({
    sender_id: 'MyBrand',
    message:   'Flash sale — 30% off today only!',
    to:        ['233201234567', '233271234567'],
  }),
});
console.log(await r.json());

async function sendBulkSms(recipients, message, senderId) {
  const res = await fetch('https://bulkiemsg.com/api/v1/sms/send', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer bm_live_YOUR_KEY',
      'Content-Type':  'application/json',
    },
    body: JSON.stringify({
      sender_id: senderId,
      message,
      to: Array.isArray(recipients) ? recipients : [recipients],
    }),
  });

  if (!res.ok && res.status !== 402) {
    throw new Error(`HTTP error: ${res.status}`);
  }

  const data = await res.json();

  if (!data.success) {
    throw new Error(data.error || 'Send failed');
  }

  return data;
}

// Usage
try {
  const result = await sendBulkSms(
    ['233201234567', '233271234567'],
    'Flash sale — 30% off today only!',
    'MyBrand'
  );
  console.log(result.message); // "Successfully sent to 2 recipient(s)."
} catch (e) {
  console.error('SMS error:', e.message);
}