Send SMS
Send an SMS to a single recipient. Parameters, response shape, and scheduled delivery.
/sms/send sends an SMS to a single recipient. An approved SenderID (title) and sufficient balance are required.
POSThttps://api.turkeysms.com.tr/sms/send
| Parameter | Type | Status | Description |
|---|---|---|---|
| api_key | string | Required | Your V4 API key. |
| title | string | Required | Approved SenderID (case-sensitive). |
| text | string | Required | Message body. Unicode is supported. |
| sentto | string | Required | International format without + (905xxxxxxxxx). |
| sms_lang | int | Optional | 0 EN · 1 TR · 2 AR/Unicode (default). |
| content_type | int | Optional | 0 Transactional · 1 High Quality · 2 Advertising. |
curl -X POST https://api.turkeysms.com.tr/sms/send \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_API_KEY",
"title": "TURKEYSMS",
"sentto": "905xxxxxxxxx",
"text": "Hello from TurkeySMS V4!"
}'200 OKResponse
{
"result": true,
"result_code": "TS-1024",
"result_message": "SMS dispatched successfully.",
"sms_id": 1000007721,
"number_of_sms": 1,
"total_recipients": 1,
"success_count": 1,
"sms_lang": "Turkish",
"content_type": "Transactional",
"country": "Turkey-TR"
}The sms_id in the response is the unique message identifier; it is used with /sms/status and /reports/*. number_of_sms is the number of segments the message was split into.
Scheduled delivery
The same /sms/send endpoint supports future delivery with three additional fields.
JSON body
{
"api_key": "YOUR_API_KEY",
"title": "TURKEYSMS",
"sentto": "905xxxxxxxxx",
"text": "Reminder: your appointment is tomorrow.",
"scheduled_sms": 1,
"scheduled_date": "2026-12-31",
"scheduled_time": "09:00"
}When
scheduled_sms is 1, both scheduled_date (YYYY-MM-DD) and scheduled_time (HH:MM) are required.