Add SMS to your applications
A JSON REST API, authenticated with a key specific to each application.
Quick start
- 1
Create an application
In your workspace, under Applications: an API key is generated for it.
- 2
Pick a sender
Use a Sender ID approved for your account.
- 3
Send your first SMS
A POST request with the key in the X-API-Key header.
Send an SMS
curl -X POST https://api.kdjcorporationgroup.com/api/v1/sms/send \
-H "X-API-Key: $KDJ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"from":"MASOCIETE","to":"2376XXXXXXXX","content":"Hello! Your order is ready.","externalId":"commande-1234"}'Response
{
"id": "3f6c2a1e-…",
"externalId": "commande-1234",
"from": "MASOCIETE",
"to": "2376XXXXXXXX",
"content": "Hello! Your order is ready.",
"dlrStatus": null,
"errorMessage": null,
"createdAt": "2026-11-20T10:15:00Z"
}Keep your key on the server side: never embed it in a mobile app or a web page.
Endpoints
- POST
/api/v1/sms/sendSends an SMS to one recipient.
- POST
/api/v1/sms/batchSends several SMS in one request, with shared or personalised content.
- GET
/api/v1/sms/status/{id}Returns the delivery status of an SMS.
- GET
/api/v1/balanceReturns your account's SMS balance.
Delivery statuses
dlrStatus = nullWaiting for the operator's delivery report.
DELIVRDDelivered to the recipient's phone.
UNDELIV, REJECTD, EXPIRED…Not delivered: invalid number, phone unreachable for too long…
errorMessage ≠ nullRefused before sending (balance, sender, number…).
Ready to send your first SMS?
Tell us about your project: the KDJ team will get back to you to open your workspace.