https://yoolasms.com/api/v1/

{

  "phone": "0704487563",

  "message": "Hello from Yoola SMS!",

  "api_key": "YOUR_API_KEY",

  "sender": "YoolaBiz"

}

{

  "phone": "0704487563,0772727716,0756123456",

  "message": "Your order has been confirmed. Thank you!",

  "api_key": "YOUR_API_KEY"

}

{

  "status": "success",

  "code": 200,

  "recipients": 3,

  "credits_used": 3,

  "balance": 282,

  "message_parts": 1

}

<?php



function sendSMS($phone, $message, $apiKey, $sender = 'YoolaSMS') {

    $url  = 'https://yoolasms.com/api/v1/send.php';

    $data = [

        'phone'   => $phone,

        'message' => $message,

        'api_key' => $apiKey,

        'sender'  => $sender,

    ];



    $ch = curl_init($url);

    curl_setopt_array($ch, [

        CURLOPT_POST           => true,

        CURLOPT_POSTFIELDS     => json_encode($data),

        CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],

        CURLOPT_RETURNTRANSFER => true,

        CURLOPT_TIMEOUT        => 30,

    ]);



    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);



    return $response;

}



// ── Single SMS ──

$result = sendSMS('0704487563', 'Your OTP is 847291. Expires in 5 minutes.', 'YOUR_API_KEY');

echo "Status: " . $result['status'] . "\n";

echo "Credits used: " . $result['credits_used'] . "\n";

echo "Balance: " . $result['balance'] . "\n";



// ── Bulk SMS ──

$phones  = implode(',', ['0704487563', '0772727716', '0756111222', '0701333444']);

$message = "Dear customer, Term 2 fees are due by 5th July. Pay to A/C 00123456. Thank you.";

$result  = sendSMS($phones, $message, 'YOUR_API_KEY', 'SchoolSMS');



echo "Sent to: " . $result['recipients'] . " recipients\n";

echo "Total credits used: " . $result['credits_used'] . "\n";

import requests



def send_sms(phone, message, api_key, sender="YoolaSMS"):

    url = "https://yoolasms.com/api/v1/send.php"

    payload = {

        "phone":   phone,

        "message": message,

        "api_key": api_key,

        "sender":  sender,

    }

    response = requests.post(url, json=payload, timeout=30)

    return response.json()



# Single SMS

result = send_sms("0704487563", "Your payment of UGX 50,000 was received. Thank you!", "YOUR_API_KEY")

print(f"Status: {result['status']}")

print(f"Credits used: {result['credits_used']}")

print(f"Remaining balance: {result['balance']}")



# Bulk to Uganda + Kenya in one call

phones = "0704487563,0772727716,+254712345678"

result = send_sms(phones, "Flash sale! 30% off all items today only. Visit our store.", "YOUR_API_KEY", "ShopAlert")

print(f"Sent to {result['recipients']} recipients across Uganda and Kenya")

const axios = require('axios');



async function sendSMS(phone, message, apiKey, sender = 'YoolaSMS') {

  const response = await axios.post('https://yoolasms.com/api/v1/send.php', {

    phone, message, api_key: apiKey, sender

  }, {

    headers: { 'Content-Type': 'application/json' },

    timeout: 30000,

  });

  return response.data;

}



// Usage

(async () => {

  // OTP / transactional

  const otp = Math.floor(100000 + Math.random() * 900000);

  const result = await sendSMS(

    '0704487563',

    `Your verification code is ${otp}. Do not share it. Expires in 5 minutes.`,

    'YOUR_API_KEY',

    'MyApp'

  );

  console.log('OTP sent:', result.status, '| Credits:', result.credits_used);



  // Bulk marketing

  const customers = ['0701111111', '0772222222', '0756333333'].join(',');

  const bulk = await sendSMS(

    customers,

    'New arrivals are here! Visit yoolasms.com to shop. Reply STOP to unsubscribe.',

    'YOUR_API_KEY',

    'ShopAlert'

  );

  console.log(`Bulk sent to ${bulk.recipients} customers`);

})();

GET https://yoolasms.com/api/v1/balance.php?api_key=YOUR_KEY

{

  "status": "success",

  "balance": 1247,

  "amount": 43645

}

POST https://yoolasms.com/api/v1/schedule_sms.php

{

  "phone": "0704487563,0772727716",

  "message": "Reminder: SACCO meeting tomorrow at 10AM at our Kampala office.",

  "api_key": "YOUR_API_KEY",

  "schedule_time": "2026-07-04 09:00:00"

}

// Uganda

sendSMS('0704487563', $message, $apiKey);       // 1 credit



// Kenya (Safaricom, Airtel Kenya)

sendSMS('+254712345678', $message, $apiKey);    // 3 credits



// Tanzania (Vodacom, Airtel)

sendSMS('+255756123456', $message, $apiKey);    // 3 credits



// Rwanda

sendSMS('+250785123456', $message, $apiKey);    // 4 credits



// UK

sendSMS('+447384014597', $message, $apiKey);    // 12 credits



// UAE

sendSMS('+971557396056', $message, $apiKey);    // 8 credits

$result = sendSMS($phone, $message, $apiKey);



switch ($result['status']) {

    case 'success':

        // Deduct credits, log the send, notify user

        logSMSSent($result['recipients'], $result['credits_used']);

        break;



    case 'insufficient_fund':

        // Trigger a top-up alert to the account owner

        notifyLowBalance($result['balance']);

        break;



    case 'invalidkey':

        // API key is wrong or revoked

        throw new Exception('Invalid Yoola SMS API key');



    case 'missing':

        // Required field missing in your request

        throw new Exception('Missing phone, message, or api_key');



    default:

        // Network error or AT gateway issue — retry with backoff

        retryAfterDelay();

}

<?php

// school_fee_reminders.php — run daily via cron



$api_key = 'YOUR_YOOLA_API_KEY';

$due_date = date('j F Y', strtotime('+7 days'));



// Get students with outstanding fees

$students = $pdo->query("

    SELECT s.parent_phone, s.student_name, f.amount_due

    FROM students s

    JOIN fees f ON s.id = f.student_id

    WHERE f.paid = 0 AND f.due_date <= DATE_ADD(NOW(), INTERVAL 7 DAY)

")->fetchAll(PDO::FETCH_ASSOC);



$sent = 0;

$failed = 0;



foreach ($students as $student) {

    $message = "Dear Parent, {$student['student_name']}'s fees of UGX " 

             . number_format($student['amount_due']) 

             . " are due by {$due_date}. Pay via MTN MoMo to 256704484563. "

             . "Questions? Call +256 704 484 563.";



    $result = sendSMS($student['parent_phone'], $message, $api_key, 'SchoolSMS');



    if ($result['status'] === 'success') {

        $sent++;

    } else {

        $failed++;

        error_log("SMS failed for {$student['parent_phone']}: {$result['message']}");

    }



    // Small delay to avoid overwhelming the API

    usleep(100000); // 0.1 second between sends

}



echo "Done. Sent: $sent | Failed: $failed\n";