PHPackages                             cecula/sms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. cecula/sms

ActiveLibrary[API Development](/categories/api)

cecula/sms
==========

PHP library for sending A2P and P2P SMS on Cecula https://www.cecula.com

v0.0.6(7y ago)017MITPHPPHP >=5.4.0

Since Apr 10Pushed 7y ago1 watchersCompare

[ Source](https://github.com/cecula-sms/php-library)[ Packagist](https://packagist.org/packages/cecula/sms)[ RSS](/packages/cecula-sms/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (6)DependenciesVersions (5)Used By (0)

Cecula SMS
==========

[](#cecula-sms)

- [Cecula SMS](#cecula-sms)
    - [Introduction](#introduction)
    - [How to Use](#how-to-use)
    - [Installation](#installation)
    - [How to Generate an API Key](#how-to-generate-an-api-key)
    - [Loading Package into your Project](#loading-package-into-your-project)
    - [Sending A2P SMS](#sending-a2p-sms)
    - [Sending P2P SMS](#sending-p2p-sms)
    - [Checking A2P SMS Balance](#checking-a2p-sms-balance)
    - [Checking Sync Cloud Balance](#checking-sync-cloud-balance)
    - [Error Response](#error-responses)

---

Introduction
------------

[](#introduction)

Cecula SMS Package (also called Library) enables you to quickly integrate and send A2P and P2P Messages from your application.

How to Use
----------

[](#how-to-use)

- Install Cecula SMS using composer by following the instructions in the Installation section or clone from GitHub
- Login to the [Cecula Developers Platform](https://developer.cecula.com) register your app and generate an API KEY
- Include or Require the **Cecula** class into your script

Installation
------------

[](#installation)

Install with composer

```
composer require cecula/sms
```

Clone from GitHub

```
git clone https//github.com/cecula/php-library.git
```

How to Generate an API Key
--------------------------

[](#how-to-generate-an-api-key)

Your API Key is first generated when you register an app. To register an app, Login to the Developers Dashboard, Navigate to **Apps > Add**, Type the name of your app and click **Submit**. The app will be registered and a new API Key will be generated. Copy the API key into your project. Click [developer.cecula.com](https://developer.cecula.com/docs/introduction/generating-api-key) to get started.

Loading Package into your Project
---------------------------------

[](#loading-package-into-your-project)

If you installed installed app with composer use the code below to load package into your project

```
require_once __DIR__."/vendor/autoload.php"
$cecula = new \Cecula\Cecula("");
```

If you cloned from github, use the code below to load package into your project

```
require_once "/path/to/class/Cecula.php";
$cecula = new \Cecula\Cecula("");
```

Sending A2P SMS
---------------

[](#sending-a2p-sms)

To send SMS with alphanumeric identity to single or multiple contacts, use the code below:

```
    $messageData = [
        "origin" => "LAB",
        "message" => "It's a good day to be alive. What are you working on?",
        "recipients" => [
            "234809xxxxxxx"
        ]
    ]

    $cecula->sendA2PSMS($messageData);
```

Your response should look like this:

```
   {
       "status": "sent",
       "reference": "4982953",
       "sentTo": [ "234809xxxxxxx" ],
       "invalid": [],
       "declined": [],
       "declineReason": "",
       "code": "1801"
   }
```

Sending P2P SMS
---------------

[](#sending-p2p-sms)

To send a message using numberic identity, use the code below:

```
   $messageData = [
       "origin" => "2348050209037",
       "message" => "Testing the power of many",
       "recipients" => [
           "2349090000246",
           "2349090000271"
       ]
   ];

   $cecula->sendP2PSMS($messageData);
```

Your response should look like this:

```
    {
        "status": "sent",
        "code": "1801",
        "messageID": "2579",
        "sentTo":[
            {
                "recipient": "2349090000246",
                "id": "5990"
            },
            {
                "recipient": "2349090000271",
                "id": "5991"
            }
        ],
        "declined": []
    }
```

Checking A2P SMS Balance
------------------------

[](#checking-a2p-sms-balance)

To get your A2P SMS Balance, **getA2PBalance** method is used this way:

```
    $cecula->getA2PBalance();
```

You should get a response like this:

```
    {
        "balance": 234.1
    }
```

Checking Sync Cloud Balance
---------------------------

[](#checking-sync-cloud-balance)

To get your Sync Cloud Balance, **getSyncCloudBalance** method is used this way: This method requires no parameter:

```
    $request = [
        "identity": "234909xxxxxxx"
    ];

    $cecula->getSyncCloudBalance($request);
```

You should get a response like this

```
    {
        "balance": 9513
    }
```

Error Responses
---------------

[](#error-responses)

In a case where the request fails due to one reason or another you should get an error response from the requested endpoint that looks like this:

```
        {
            "error": "Invalid PIN Ref",
            "code": "CE2000"
        }
```

The table below shows a list of error codes and their descriptions:

Error CodeDescriptionCE1001Missing FieldsCE1002Empty FieldsCE1003Origin cannot be longer than 11 charactersCE1004A2P Message origin must be alphabets only or alphanumericCE1005Message cannot be longer than 10 pagesCE1007Cannot find the identity on Sync CloudCE1008Origin is pending verificationCE1009Account Unbound. Please Recharge Account and Contact SalesCE1010Numeric Originator must be between 5 - 16 digits longCE1011P2P Message originator must be numericCE1012Origin is not verifiedCE1013Sync App is Offline. Please check device

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~7 days

Total

4

Last Release

2570d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/32046404388def9a9a99677a67ff43a5bcf77756efe367db4583bc705a648196?d=identicon)[vereafy](/maintainers/vereafy)

---

Top Contributors

[![bbnplace](https://avatars.githubusercontent.com/u/3621257?v=4)](https://github.com/bbnplace "bbnplace (7 commits)")

---

Tags

apismstextmessagingNigeriap2pbulkA2PbulksmsCeculabbn

### Embed Badge

![Health badge](/badges/cecula-sms/health.svg)

```
[![Health](https://phpackages.com/badges/cecula-sms/health.svg)](https://phpackages.com/packages/cecula-sms)
```

###  Alternatives

[mobizon/mobizon-php

A PHP library for communicating with the Mobizon API. Mobizon is a powerful SMS gateway and online marketing tools.

18115.1k1](/packages/mobizon-mobizon-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)