Développeurs

Envoyez votre premier SMS en 5 minutes.

Une API REST simple pour envoyer des SMS vers tous les numéros tunisiens, des exemples prêts à copier pour votre langage, et des webhooks pour suivre chaque message.

Démarrage rapide

1. Créez une clé APIDans votre espace Sendimo. Commencez avec une clé de test sk_test_ : rien n’est envoyé ni facturé.
2. Envoyez un SMSUn POST sur /v1/messages. La réponse 202 contient l’identifiant du message et son coût.
3. Suivez la livraisonRecevez message.delivered ou message.failed sur votre webhook, sans interroger l’API.
Envoyer un SMScURL
curl -X POST https://api.sendimo.tn/v1/messages \
  -H "Authorization: Bearer $SENDIMO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4821-otp" \
  -d '{
    "to": "+21620123456",
    "from": "SENDIMO",
    "text": "Votre code est 482913. Il expire dans 5 minutes.",
    "reference": "order-4821"
  }'
Réponse 202 AcceptedJSON
{
  "id": "msg_01HF8Z3K9QX2",
  "status": "queued",
  "to": "+21620123456",
  "from": "SENDIMO",
  "text": "Votre code est 482913. Il expire dans 5 minutes.",
  "encoding": "GSM-7",
  "segments": 1,
  "network": "ooredoo",
  "cost": { "amount": "0.140", "currency": "TND" },
  "reference": "order-4821",
  "scheduled_at": null,
  "created_at": "2026-10-30T09:15:00Z"
}

L’essentiel

ÉlémentValeur
URL de basehttps://api.sendimo.tn/v1
ProtocoleHTTPS uniquement (TLS 1.2+)
FormatJSON, UTF-8, Content-Type: application/json
AuthentificationAuthorization: Bearer sk_live_… (ou sk_test_…)
VersionsVersion majeure dans le chemin (/v1). Les ajouts non cassants sont publiés sans changer de version.
DatesISO 8601, UTC (2026-10-30T09:15:00Z)
IdentifiantsChaînes préfixées : msg_…, bat_…, snd_…
MontantsChaîne à 3 décimales, en TND ("0.140")
NumérosE.164 (+21620123456). Les numéros locaux à 8 chiffres sont acceptés et convertis en +216.

Endpoints v1

MéthodeCheminRôle
POST/messagesEnvoyer un SMS
POST/messages/bulkEnvoyer le même SMS, ou des SMS personnalisés, à plusieurs numéros
GET/messages/{id}Obtenir un message et son statut
GET/messagesLister les messages (filtres et pagination)
DELETE/messages/{id}Annuler un message programmé
GET/batches/{id}Suivre la progression d’un envoi en masse
GET/sender-idsLister vos noms d’expéditeur approuvés
POST/sender-idsDemander un nouveau nom d’expéditeur
GET/account/balanceConsulter le solde restant
Voir la référence complète

Votre langage n’est pas listé ? L’API REST fonctionne avec tout langage capable d’envoyer une requête HTTP.

Besoin d’une autre intégration ? Parlons-en

Prêt à envoyer vos SMS ?

Lancement bientôt en Tunisie. Rejoignez l’accès anticipé.