Send email, SMS and WhatsApp
from the system you already run.

curl -X POST https://besends.com/api/sms/send \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "contact": [
      {
        "number": "8801712345678",
        "message": "Your fee for September is due on 12 Sep. Pay at the accounts desk."
      },
      {
        "number": "8801812345678",
        "message": "Reminder: your appointment is tomorrow at 10:00.",
        "schedule_at": "2026-09-08 09:00:00"
      }
    ]
  }'

<?php
$payload = [
    'contact' => [
        [
            'number'  => '8801712345678',
            'message' => 'Your fee for September is due on 12 Sep.',
        ],
        [
            'number'      => '8801812345678',
            'message'     => 'Reminder: your appointment is tomorrow at 10:00.',
            'schedule_at' => '2026-09-08 09:00:00',
        ],
    ],
];

$ch = curl_init('https://besends.com/api/sms/send');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Api-key: ' . getenv('CONNECTS_API_KEY'),
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_TIMEOUT        => 30,
]);

$body = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($body, true);

if ($code !== 200 || empty($result['success'])) {
    // Log it and move on — never let a failed SMS break the calling process.
    error_log('BeSends: ' . $body);
} else {
    foreach ($result['data'] as $log) {
        echo "queued {$log['id']}\n";
    }
}

import os
import requests

BASE = "https://besends.com/api"
KEY  = os.environ["CONNECTS_API_KEY"]

def send_sms(messages):
    """messages: list of {"number": str, "message": str, "schedule_at": str|None}"""
    response = requests.post(
        f"{BASE}/sms/send",
        headers={
            "Api-key": KEY,
            "Content-Type": "application/json",
            "Accept": "application/json",
        },
        json={"contact": messages},
        timeout=30,
    )

    body = response.json()

    if response.status_code != 200 or not body.get("success"):
        raise RuntimeError(f"BeSends rejected the send: {body}")

    return [row["id"] for row in body["data"]]


ids = send_sms([
    {"number": "8801712345678",
     "message": "Your fee for September is due on 12 Sep."},
    {"number": "8801812345678",
     "message": "Reminder: your appointment is tomorrow at 10:00.",
     "schedule_at": "2026-09-08 09:00:00"},
])
print("queued:", ids)

const BASE = 'https://besends.com/api';
const KEY  = process.env.CONNECTS_API_KEY;

async function sendSms(contact) {
  const res = await fetch(`${BASE}/sms/send`, {
    method: 'POST',
    headers: {
      'Api-key': KEY,
      'Content-Type': 'application/json',
      'Accept': 'application/json',
    },
    body: JSON.stringify({ contact }),
  });

  const body = await res.json();

  if (!res.ok || !body.success) {
    throw new Error(`BeSends rejected the send: ${JSON.stringify(body)}`);
  }

  return body.data.map((row) => row.id);
}

const ids = await sendSms([
  { number: '8801712345678',
    message: 'Your fee for September is due on 12 Sep.' },
  { number: '8801812345678',
    message: 'Reminder: your appointment is tomorrow at 10:00.',
    schedule_at: '2026-09-08 09:00:00' },
]);

console.log('queued:', ids);

import java.net.URI;
import java.net.http.*;
import java.time.Duration;

public class BeSends {
    static final String BASE = "https://besends.com/api";
    static final String KEY  = System.getenv("CONNECTS_API_KEY");

    public static String sendSms(String json) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE + "/sms/send"))
            .header("Api-key", KEY)
            .header("Content-Type", "application/json")
            .header("Accept", "application/json")
            .timeout(Duration.ofSeconds(30))
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        if (response.statusCode() != 200) {
            throw new RuntimeException("BeSends: " + response.body());
        }
        return response.body();
    }

    public static void main(String[] args) throws Exception {
        String payload = """
            { "contact": [
                { "number": "8801712345678",
                  "message": "Your fee for September is due on 12 Sep." }
            ] }
            """;
        System.out.println(sendSms(payload));
    }
}

using System.Net.Http.Json;
using System.Text.Json;

var baseUrl = "https://besends.com/api";
var key     = Environment.GetEnvironmentVariable("CONNECTS_API_KEY");

using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
http.DefaultRequestHeaders.Add("Api-key", key);
http.DefaultRequestHeaders.Add("Accept", "application/json");

var payload = new
{
    contact = new[]
    {
        new { number = "8801712345678",
              message = "Your fee for September is due on 12 Sep." }
    }
};

var response = await http.PostAsJsonAsync($"{baseUrl}/sms/send", payload);
var body = await response.Content.ReadAsStringAsync();

if (!response.IsSuccessStatusCode)
    throw new Exception($"BeSends rejected the send: {body}");

Console.WriteLine(body);

curl -G "https://besends.com/api/sms/send" \
  -H "Api-key: YOUR_API_KEY" \
  --data-urlencode "contacts=8801712345678,8801812345678" \
  --data-urlencode "message=Your order has shipped."

curl -X POST https://besends.com/api/email/send \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "contact": [
      {
        "email": "finance@acme.com.bd",
        "subject": "Invoice INV-2026-0912",
        "message": "<p>Dear Acme,</p><p>Invoice <b>INV-2026-0912</b> for BDT 48,500 is attached and due on 21 September.</p>",
        "sender_name": "Acme Accounts",
        "reply_to_email": "accounts@yourcompany.com.bd"
      }
    ]
  }'

<?php
// With an attachment the request must be multipart, not JSON.
$post = [
    'contact[0][email]'       => 'finance@acme.com.bd',
    'contact[0][subject]'     => 'Invoice INV-2026-0912',
    'contact[0][message]'     => '<p>Invoice attached, due 21 September.</p>',
    'contact[0][sender_name]' => 'Acme Accounts',
    'attachments[0]'          => new CURLFile('/srv/invoices/INV-2026-0912.pdf'),
];

$ch = curl_init('https://besends.com/api/email/send');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Api-key: ' . getenv('CONNECTS_API_KEY'),
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS     => $post,   // no json_encode — let curl build multipart
    CURLOPT_TIMEOUT        => 60,
]);

echo curl_exec($ch);
curl_close($ch);

import os, requests

BASE = "https://besends.com/api"
KEY  = os.environ["CONNECTS_API_KEY"]

# Multipart, because we are attaching a file.
data = {
    "contact[0][email]":   "finance@acme.com.bd",
    "contact[0][subject]": "Invoice INV-2026-0912",
    "contact[0][message]": "<p>Invoice attached, due 21 September.</p>",
}

with open("/srv/invoices/INV-2026-0912.pdf", "rb") as fh:
    response = requests.post(
        f"{BASE}/email/send",
        headers={"Api-key": KEY, "Accept": "application/json"},
        data=data,
        files={"attachments[0]": fh},
        timeout=60,
    )

print(response.status_code, response.json())

curl -X POST https://besends.com/api/whatsapp/send \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "contact": [
      {
        "number": "8801712345678",
        "message": "Your parcel is out for delivery. Reply 1 to reschedule."
      },
      {
        "number": "8801812345678",
        "message": "Your statement for August is attached.",
        "media": "document",
        "url": "https://files.yourcompany.com.bd/statements/aug-2026.pdf",
        "filename": "Statement-August-2026.pdf"
      }
    ]
  }'

curl -X POST https://besends.com/api/v1/otp/send \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "phone": "01712345678",
    "email": "customer@example.com",
    "order": ["whatsapp", "sms", "email"],
    "length": 6,
    "ttl": 300,
    "reference": "order-88213"
  }'

{
  "success": true,
  "message": "Code sent.",
  "data": {
    "otp_id": "otp_k3v9x2m1q8p4z7n6a5b0",
    "status": "sent",
    "delivered_channel": "sms",
    "channel_order": ["whatsapp", "sms", "email"],
    "attempts": [
      { "channel": "whatsapp", "ok": false, "error": "number is not on WhatsApp", "ms": 640 },
      { "channel": "sms",      "ok": true,  "error": null, "ms": 910 }
    ],
    "expires_at": "2026-09-08T12:05:00+06:00",
    "charged": 0.5,
    "reference": "order-88213",
    "balance": 499.5
  }
}

curl -X POST https://besends.com/api/v1/otp/verify \
  -H "Api-key: YOUR_API_KEY" \
  -d "otp_id=otp_k3v9x2m1q8p4z7n6a5b0" -d "code=482913"

# 200 → {"success":true,"message":"Verified.","data":{"status":"verified", ...}}
# 400 → {"success":false,"message":"Wrong code.","data":{"attempts_left":4, ...}}
# 410 → expired or already used

curl "https://besends.com/api/get/sms/84213" \
  -H "Api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

{
  "success": true,
  "message": "Successfully fetched Sms from Logs",
  "data": {
    "id": 84213,
    "created_at": "2026-09-07 14:02:11",
    "status": "delivered",
    "message": {
      "message": "Your order #4417 is out for delivery."
    },
    "contact": {
      "first_name": "Rina",
      "last_name": "Haque",
      "email_contact": "8801712345678",
      "meta_data": null
    }
  }
}