Developers
Send your first SMS in 5 minutes.
A simple REST API to send SMS to every Tunisian number, copy-paste examples for your language, and webhooks to track every message.
Quickstart
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": "Your code is 482913. It expires in 5 minutes.",
"reference": "order-4821"
}'{
"id": "msg_01HF8Z3K9QX2",
"status": "queued",
"to": "+21620123456",
"from": "SENDIMO",
"text": "Your code is 482913. It expires in 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"
}Essentials
| Item | Value |
|---|---|
Base URL | https://api.sendimo.tn/v1 |
Protocol | HTTPS only (TLS 1.2+) |
Format | JSON, UTF-8, Content-Type: application/json |
Authentication | Authorization: Bearer sk_live_… (or sk_test_…) |
Versioning | Major version in the path (/v1). Non-breaking additions ship without a version bump. |
Timestamps | ISO 8601, UTC (2026-10-30T09:15:00Z) |
IDs | Prefixed strings: msg_…, bat_…, snd_… |
Money | String with 3 decimals, in TND ("0.140") |
Phone numbers | E.164 (+21620123456). Local 8-digit numbers are accepted and normalized to +216. |
v1 endpoints
| Method | Path | Purpose |
|---|---|---|
POST | /messages | Send one SMS |
POST | /messages/bulk | Send the same or personalized SMS to many numbers |
GET | /messages/{id} | Get one message and its status |
GET | /messages | List messages (filters + pagination) |
DELETE | /messages/{id} | Cancel a scheduled message |
GET | /batches/{id} | Get bulk send progress |
GET | /sender-ids | List your approved sender names |
POST | /sender-ids | Request a new sender name |
GET | /account/balance | Get remaining balance |
Libraries
Official libraries for your language, with the same API everywhere.
Send SMS in Tunisia from Python with the Sendimo API.
View integrationSend SMS in Tunisia from PHP, with no dependency.
View integrationSend SMS in Tunisia from Laravel with the built-in HTTP client.
View integrationSend SMS in Tunisia from Node.js with fetch.
View integrationSend SMS in Tunisia from Java, with no dependency.
View integrationSend SMS in Tunisia from Spring Boot with RestClient.
View integrationSend SMS in Tunisia from Go with net/http.
View integrationPlugins
Send SMS from your store or website, without coding.
API
The foundation: the REST API and webhooks, for every other language and tool.
Language not listed? The REST API works with any language that can send an HTTP request.
Need another integration? Talk to us