iamphort/kenosms-php

There is no license information available for the latest version (0.1.0) of this package.

PHP SDK for KenoSMS API

0.1.0 2026-02-20 16:51 UTC

Requires

• php: >=7.4

Unknown License

README

Official PHP SDK for sending and managing SMS via the KenoSMS HTTP API.

This SDK provides a simple interface for:

• Sending SMS messages
• Scheduling SMS delivery
• Retrieving a single SMS by UID
• Listing all SMS messages

Installation

Install via Composer:

composer require iamphort/kenosms-php

Requirements

• PHP 7.4 or higher
• cURL extension enabled
• Composer

Getting Started

1. Include Composer Autoload

require 'vendor/autoload.php';

2. Import the Namespace

use KenoSMS\KenoSMS;

3. Initialize the Client

$sms = new KenoSMS("YOUR_API_TOKEN");

Replace YOUR_API_TOKEN with your actual API token provided by KenoSMS.

Send SMS

$response = $sms->sendSMS(
    "2557XXXXXXXX",
    "KENOSMS",
    "Hello from KenoSMS PHP SDK!"
);

print_r($response);

Parameters

Parameter	Type	Required	Description
recipient	string	Yes	Recipient phone number (e.g., 2557XXXXXXXX)
sender_id	string	Yes	Registered Sender ID
message	string	Yes	SMS message content
type	string	No	SMS type (default: plain)
schedule_time	string	No	Schedule date/time (YYYY-MM-DD HH:MM:SS)
dlt_template_id	string	No	DLT Template ID if required

Send Scheduled SMS

$response = $sms->sendSMS(
    "2557XXXXXXXX",
    "KENOSMS",
    "This message is scheduled",
    "plain",
    "2026-02-25 10:00:00"
);

print_r($response);

Get a Single SMS

Retrieve SMS details using its unique ID (UID):

$response = $sms->getSMS("SMS_UNIQUE_ID");

print_r($response);

List All SMS

$response = $sms->listSMS();

print_r($response);

API Endpoint

This SDK communicates with:

https://sms.kenosis.co.tz/api/http/sms

Error Handling Example

try {
    $response = $sms->sendSMS(
        "2557XXXXXXXX",
        "KENOSMS",
        "Testing error handling"
    );

    print_r($response);
} catch (Exception $e) {
    echo "Error: " . $e->getMessage();
}

Response Format

All methods return a decoded JSON response as an associative array.

Example:

Array
(
    [status] => success
    [message] => SMS sent successfully
    [data] => Array
        (
            [uid] => abc123xyz
        )
)

License

MIT License

Author

KenoSMS Website: https://sms.kenosis.co.tz