Documentation API

API ZomloaSMS

Intégrez l’envoi de SMS et le suivi de solde en quelques minutes. Endpoints clairs, exemples prêts à copier, réponses JSON prévisibles.

Commencer Obtenir une clé API

REST

API v1

<15s

OTP typique

HMAC

Webhooks signés

24/7

Support

+1 000

Développeurs & entreprises

I. Premiers pas

De zéro à votre premier SMS

Trois étapes pour brancher ZomloaSMS à votre application.

Créez un compte

Inscrivez-vous sur sms.zomloa.com/signup — SMS offerts pour tester l’API.

Générez votre clé API

Dans le panel, section API → Générer une clé, puis testez avec vos crédits offerts.

Pack → Sender ID → Envoi

Achetez un forfait, demandez votre Sender ID, puis envoyez via panel ou API.

Base URL https://api.sms.zomloa.com

II. Endpoints & ressources

Ressources HTTP

Toutes les opérations acceptent POST ou GET. Préférez POST pour les données sensibles.

II.1 Opération d’envoi de SMS

GET/POSThttps://api.sms.zomloa.com/v1/sms.php

II.1.1 Requête

Paramètre	Type	Description
`api_key`obligatoire Clé d’accès générée depuis votre compte ZomloaSMS.	string	Clé d’accès générée depuis votre compte ZomloaSMS.
`senderid`obligatoire Nom d’expéditeur (Sender ID), max. 11 caractères.	string	Nom d’expéditeur (Sender ID), max. 11 caractères.
`sms`obligatoire Contenu du message (facturé par segment de 160 caractères).	string	Contenu du message (facturé par segment de 160 caractères).
`mobiles`obligatoire Numéros séparés par des virgules. Préfixe "237" facultatif. Ex. : 237XXXXXXXXX,XXXXXXXXX	string	Numéros séparés par des virgules. Préfixe "237" facultatif. Ex. : 237XXXXXXXXX,XXXXXXXXX

https://api.sms.zomloa.com/v1/sms.php

curl -X POST "https://api.sms.zomloa.com/v1/sms.php" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "api_key=zs_live_xxxxxxxx" \
  -d "senderid=ZOMLOA" \
  -d "sms=Votre code : 482913" \
  -d "mobiles=237670000000,670000001"

II.1.2 Réponse

Paramètre	Type	Description
`responsecode` 1 si succès, 0 si erreur.	integer	1 si succès, 0 si erreur.
`responsedescription` "success" ou "error".	string	"success" ou "error".
`responsemessage` Message descriptif de la requête.	string	Message descriptif de la requête.
`sms[].messageid` Identifiant unique du message.	string	Identifiant unique du message.
`sms[].smsclientid` Identifiant de la requête client.	string	Identifiant de la requête client.
`sms[].mobileno` Numéro du destinataire.	string	Numéro du destinataire.
`sms[].statut` "success" ou "error".	string	"success" ou "error".
`balance` Solde restant après l’envoi.	string	Solde restant après l’envoi.

application/json

{
  "responsecode": 1,
  "responsedescription": "success",
  "responsemessage": "success",
  "sms": [
    {
      "messageid": "c2b849db106f0c2e07dd9b881e6bdfe7",
      "smsclientid": "0c851d9f-6c63-49fb-af16-6886c37a81de",
      "mobileno": "+237670000000",
      "statut": "success",
      "errorcode": "",
      "errordescription": ""
    }
  ],
  "balance": "1017"
}

II.2 Vérification du solde de SMS

GET/POSThttps://api.sms.zomloa.com/v1/smscredit.php

II.2.1 Requête

Paramètre	Type	Description
`api_key`obligatoire Clé d’accès générée depuis votre compte ZomloaSMS.	string	Clé d’accès générée depuis votre compte ZomloaSMS.

https://api.sms.zomloa.com/v1/smscredit.php

curl -X POST "https://api.sms.zomloa.com/v1/smscredit.php" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "api_key=zs_live_xxxxxxxx"

II.2.2 Réponse

Paramètre	Type	Description
`responsecode`obligatoire 1 si succès, 0 si erreur.	integer	1 si succès, 0 si erreur.
`subscriptiondate`obligatoire Date de souscription.	string	Date de souscription.
`packname`obligatoire Nom du pack actif.	string	Nom du pack actif.
`responsemessage`obligatoire Description de la requête.	string	Description de la requête.
`credit`obligatoire Solde SMS disponible.	string	Solde SMS disponible.

application/json

{
  "responsecode": 1,
  "subscriptiondate": "2026-04-11",
  "packname": "Pack Freedom",
  "responsemessage": "success",
  "credit": "1017"
}

III. Gestion des erreurs

Codes & messages

En cas d’échec, responsecode vaut 0. Consultez errorcode / errordescription dans le payload.

Codes d’erreur

-100019Utilisateur inactif
-10003Numéro de téléphone invalide

Messages d’erreur fréquents

Password require
User name require
Sender ID require
Mobiles required
Message require
Invalid user name or password
Your balance is insufficient

Prêt à intégrer ZomloaSMS ?

Créez un compte, générez votre clé et envoyez votre premier SMS en moins de 5 minutes.

Créer un compte gratuit Parler à un expert

Docs live · sms.zomloa.com

Commencez avec des SMS gratuits

SMS offerts pour tester l’API, packs volume et support — tout pour lancer sans friction.

Une seule API. Tous les opérateurs. Des SMS qui arrivent.

S'inscrire gratuitement Voir les tarifs