Quickstart
Send your first SMS in minutes. Get an API key, make the call, read the response.
The TurkeySMS API V4 is a JSON/REST API. Every endpoint uses the POST method and authentication is done with the api_key field inside the JSON body. The three steps below are all you need to send your first message.
1
Get an API key
Create a key in your account under API Center → My Keys. No credit card required.
2
Make the request
Send a POST request to /sms/send with the
Content-Type: application/json header.3
Read the response
Check the
result_code and sms_id fields in the response. Use sms_id to query status later.Your first request
POSThttps://api.turkeysms.com.tr/sms/send
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 OKSuccessful response
{
"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"
}Replace
YOUR_API_KEY with your own key. Before sending, it is recommended to validate your key and permissions with /auth/check.What is next
- Authentication — key security and
/auth/check. - Send SMS — all parameters and scheduled delivery.
- Webhooks — receive delivery events on your server.
- Response Codes — the meaning of every
TS-####code.