Welcome to the ultimate developer's hub. The TurkeySMS API delivers robust, secure, and scalable programmatic solutions to integrate SMS capabilities directly into your digital ecosystem — whether you're building web platforms, mobile apps, or enterprise ERP systems.

Our API is engineered to perform seamlessly across all modern environments, including Node.js, Python, PHP, and C#. We provide comprehensive SDKs and dedicated tools to minimize integration time while maximizing message delivery performance.

Experience the power of our API in real-time. Our interactive documentation allows you to test endpoints, view schemas, and understand response structures directly from your browser.

TurkeySMS Swagger V4

Fully compatible with OpenAPI 3.0 specs. Try out SMS, OTP, and reports without writing a single line of code.

Launch Interactive Docs →

Integrating with TurkeySMS empowers you to establish intelligent, real-time communication channels. From automated system triggers to multi-factor authentication (OTP), we provide the reliable backbone for your communications, meeting the highest international security standards.

To ensure a successful integration and maintain regulatory compliance, please verify the following requirements:

Start sending your first SMS in just 3 steps:

require_once 'TurkeySmsClient_EN.php';
$client = new TurkeySmsClient('YOUR_API_KEY');
$result = $client->sendSms('SenderID', '905xxxxxxxxx', 'Hello!');

if ($client->isLastSuccess()) {
    echo "✅ Sent! ID: " . $result['sms_id'];
}

import requests

url = "https://api.turkeysms.com.tr/sms/send"
data = {
    "api_key": "YOUR_API_KEY",
    "title":   "SenderID",
    "sentto":  "905xxxxxxxxx",
    "text":    "Hello!"
}
result = requests.post(url, json=data).json()
print(result)

const axios = require('axios');

const result = await axios.post('https://api.turkeysms.com.tr/sms/send', {
    api_key: 'YOUR_API_KEY',
    title:   'SenderID',
    sentto:  '905xxxxxxxxx',
    text:    'Hello!'
});
console.log(result.data);

Authentication is handled using your unique API key, sent within the JSON request body. You can find your API key in your control panel under My Account → API Settings.

Verify your API key and retrieve all granted permissions (Sending, OTP, Balance) along with the current account status.

curl -X POST https://api.turkeysms.com.tr/auth/check \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY" }'

$ch = curl_init("https://api.turkeysms.com.tr/auth/check");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS     => json_encode(["api_key" => "YOUR_API_KEY"]),
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
]);
echo curl_exec($ch);

result = requests.post("https://api.turkeysms.com.tr/auth/check",
    json={"api_key": "YOUR_API_KEY"}).json()
print(result)

const r = await axios.post('https://api.turkeysms.com.tr/auth/check',
    { api_key: 'YOUR_API_KEY' });
console.log(r.data);

Response Example

{
  "result": true,
  "result_code": "TS-1000",
  "key_details": {
    "status": "Active",
    "permissions": {
      "post_request": true, "send_single_sms": true,
      "send_otp": true,     "check_balance": true
    }
  },
  "account_summary": {
    "account_status": "Active",
    "balance": { "main": 1500, "international": 250 }
  }
}

Send a single SMS to a specific phone number with a POST request:

Parameters

Request Example

curl -X POST https://api.turkeysms.com.tr/sms/send \
-H "Content-Type: application/json" \
-d '{
  "api_key":      "YOUR_API_KEY",
  "title":        "MyCompany",
  "text":         "Hello! This is a test message.",
  "sentto":       "905xxxxxxxxx",
  "sms_lang":     0,
  "content_type": 0
}'

$data = [
  "api_key"      => "YOUR_API_KEY",
  "title"        => "MyCompany",
  "text"         => "Hello! This is a test message.",
  "sentto"       => "905xxxxxxxxx",
  "sms_lang"     => 0,
  "content_type" => 0,
];
$ch = curl_init("https://api.turkeysms.com.tr/sms/send");
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => json_encode($data), CURLOPT_HTTPHEADER => ['Content-Type: application/json']]);
echo curl_exec($ch);

result = requests.post("https://api.turkeysms.com.tr/sms/send", json={
    "api_key":      "YOUR_API_KEY",
    "title":        "MyCompany",
    "text":         "Hello! This is a test message.",
    "sentto":       "905xxxxxxxxx",
    "sms_lang":     0,
    "content_type": 0,
}).json()
print(result)

const r = await axios.post('https://api.turkeysms.com.tr/sms/send', {
  api_key:      'YOUR_API_KEY',
  title:        'MyCompany',
  text:         'Hello! This is a test message.',
  sentto:       '905xxxxxxxxx',
  sms_lang:     0,
  content_type: 0,
});
console.log(r.data);

Success Response

{
  "result":         true,
  "result_code":    "TS-1024",
  "result_message": "SMS dispatched successfully.",
  "sms_id":         1000007721,
  "number_of_sms":  1,
  "sms_lang":       "English",
  "content_type":   "Transactional",
  "country":        "Turkey-TR"
}

Special endpoint for sending One-Time Passwords (OTP). Ensures ultra-fast delivery with the highest priority in the messaging queue.

Parameters

Request Example

curl -X POST https://api.turkeysms.com.tr/otp/send \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "mobile": "905xxxxxxxxx", "lang": 0, "digits": 4 }'

$ch = curl_init("https://api.turkeysms.com.tr/otp/send");
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => json_encode(["api_key" => "YOUR_API_KEY", "mobile" => "905xxxxxxxxx", "lang" => 0, "digits" => 4]),
    CURLOPT_HTTPHEADER => ['Content-Type: application/json']]);
echo curl_exec($ch);

result = requests.post("https://api.turkeysms.com.tr/otp/send",
    json={"api_key": "YOUR_API_KEY", "mobile": "905xxxxxxxxx", "lang": 0, "digits": 4}).json()
print(result)

const r = await axios.post('https://api.turkeysms.com.tr/otp/send',
    { api_key: 'YOUR_API_KEY', mobile: '905xxxxxxxxx', lang: 0, digits: 4 });
console.log(r.data);

Control the full OTP message text. You must include the keyword TS-CODE in the text — it will be automatically replaced with the generated OTP code. An active Sender ID is required.

curl -X POST https://api.turkeysms.com.tr/otp/detailed \
-H "Content-Type: application/json" \
-d '{
  "api_key": "YOUR_API_KEY",
  "mobile":  "905xxxxxxxxx",
  "title":   "YOUR_TITLE",
  "text":    "Welcome! Your verification code is: TS-CODE",
  "lang":    0,
  "digits":  4
}'

curl_setopt_array($ch = curl_init("https://api.turkeysms.com.tr/otp/detailed"), [
    CURLOPT_POST           => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS     => json_encode([
        "api_key" => "YOUR_API_KEY", "mobile" => "905xxxxxxxxx",
        "title"   => "YOUR_TITLE",   "text"   => "Your code: TS-CODE",
        "lang"    => 0,               "digits" => 4
    ]),
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json']
]);
echo curl_exec($ch);

result = requests.post("https://api.turkeysms.com.tr/otp/detailed", json={
    "api_key": "YOUR_API_KEY", "mobile": "905xxxxxxxxx",
    "title":   "YOUR_TITLE",   "text":   "Your code: TS-CODE",
    "lang":    0,               "digits": 4
}).json()

Schedule messages to be sent at a specific future date and time. Uses the same /sms/send endpoint with additional scheduling parameters.

curl -X POST https://api.turkeysms.com.tr/sms/send \
-H "Content-Type: application/json" \
-d '{
  "api_key":        "YOUR_API_KEY",
  "title":          "MyCompany",
  "text":           "Scheduled message content",
  "sentto":         "905xxxxxxxxx",
  "scheduled_sms":  1,
  "scheduled_date": "2026-12-31",
  "scheduled_time": "09:00"
}'

Send messages to multiple recipients in two ways depending on your campaign needs.

1. Single Text to Multiple Numbers

Send a fixed message to a list of numbers.

curl -X POST https://api.turkeysms.com.tr/group/send \
-H "Content-Type: application/json" \
-d '{
  "api_key": "YOUR_API_KEY",
  "title":   "SenderID",
  "text":    "Universal message for all",
  "sentto":  ["905000000001", "905000000002", "905000000003"]
}'

2. Multiple Texts to Multiple Numbers

Send personalized messages to each number (array indices must match).

curl -X POST https://api.turkeysms.com.tr/group/sendMixed \
-H "Content-Type: application/json" \
-d '{
  "api_key": "YOUR_API_KEY",
  "title":   "SenderID",
  "text":    ["Hello Alice", "Hello Bob"],
  "sentto":  ["905000000001", "905000000002"]
}'

Message Language — sms_lang

Content Type — content_type

Query your remaining SMS credits programmatically. Requires Check Balance permission in your API settings.

curl -X POST https://api.turkeysms.com.tr/balance/ \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY" }'

curl_setopt_array($ch = curl_init("https://api.turkeysms.com.tr/balance/"), [
    CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => json_encode(["api_key" => "YOUR_API_KEY"]),
    CURLOPT_HTTPHEADER => ['Content-Type: application/json']]);
echo curl_exec($ch);

result = requests.post("https://api.turkeysms.com.tr/balance/",
    json={"api_key": "YOUR_API_KEY"}).json()
print(result)

Query the list of active Sender IDs in your account. Enable the Sender ID Inquiry option in your API key settings first.

curl -X POST https://api.turkeysms.com.tr/senderid/check \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY" }'

curl_setopt_array($ch = curl_init("https://api.turkeysms.com.tr/senderid/check"), [
    CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => json_encode(["api_key" => "YOUR_API_KEY"]),
    CURLOPT_HTTPHEADER => ['Content-Type: application/json']]);
echo curl_exec($ch);

Response Example

{
  "result": true, "result_code": "TS-1040",
  "sender_ids": [
    { "id": 12345, "title": "TurkeySMS", "status": 1, "document": 1, "network_stat": 1 }
  ]
}

Two types of reports to track message status: Basic Report for a general summary, and Detailed Report for per-number status tracking.

1. Basic Report (Summary)

curl -X POST https://api.turkeysms.com.tr/reports/basic \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "raporid": 12345 }'

{ "result": true, "rapor_id": 12345, "total_numbers": 1000,
  "success_count": 950, "failed_count": 30, "pending_count": 20 }

2. Detailed Report (Paginated)

Per-number status tracking. Supports pagination with a limit of 500 records per page.

{
  "result": true, "result_code": "TS-1064",
  "pagination": { "current_page": 1, "total_pages": 5, "total_records": 2350 },
  "data": [{ "phone_number": "905xxxxxxxxx", "sent_at": "2026-04-03 12:00:00", "sms_status": "Number received the message" }]
}

Query the delivery status of a specific message using the unique SMS ID received during sending.

curl -X POST https://api.turkeysms.com.tr/sms/status \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "sms_id": 12345678 }'

{
  "status": "success", "result_code": "TS-1064", "result": true,
  "sender_id": "SENDER", "sms_status": "Number received the message",
  "sms_balance": "1 SMS"
}

Manage your contact groups programmatically. Create, edit, delete, or list groups.

1. Create New Group

curl -X POST https://api.turkeysms.com.tr/groups/create \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "group_name": "My New Group" }'

{ "result": true, "result_code": "TS-1080", "group": { "id": 5412, "name": "My New Group", "created_at": "2026-04-03" } }

2. Edit Group Name

curl -X POST https://api.turkeysms.com.tr/groups/edit \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "group_id": 1234, "new_name": "Updated Name" }'

3. Delete Group

curl -X POST https://api.turkeysms.com.tr/groups/delete \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "group_id": 1234 }'

4. List Groups

curl -X POST https://api.turkeysms.com.tr/groups/list \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "search": "Team" }'

{ "result": true, "result_code": "TS-1090", "groups_count": 2,
  "groups": [
    { "id": 123, "name": "Team A", "date": "2026-04-01" },
    { "id": 456, "name": "Clients", "date": "2026-04-02" }
  ] }

Add or remove phone numbers from your contact groups programmatically, with support for custom fields.

Add Number to Group

Parameters: api_key, group_id, gsm_number (required). Optional: name, f_01, f_02, f_03.

curl -X POST https://api.turkeysms.com.tr/contacts/add \
-H "Content-Type: application/json" \
-d '{
  "api_key":    "YOUR_API_KEY",
  "group_id":   1234,
  "gsm_number": "905051234567",
  "name":       "John Doe",
  "f_01":       "Extra Info"
}'

{ "result": true, "result_code": "TS-1100",
  "group_id": 5412, "total_added": 1, "total_failed": 0, "mobile": "905051234567" }

Block specific phone numbers to prevent any messages from being sent to them. Managed independently per user.

1. Add Number to Blacklist

curl -X POST https://api.turkeysms.com.tr/blacklist/add \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "number": "905xxxxxxxx" }'

2. Check Blacklist Status

curl -X POST https://api.turkeysms.com.tr/blacklist/status \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY", "number": "905xxxxxxxx" }'

{ "status": "success", "result_code": "TS-1143",
  "is_blocked": true, "block_date": "2026-04-03", "block_time": "17:50" }

Instead of polling the API for message status, TurkeySMS provides Webhooks to push detailed delivery reports directly to your server as soon as they are updated by the operator.

Signature Verification (Security)

We include the X-TurkeySms-Signature header — an HMAC-SHA256 hash of the request body using your Webhook Secret Key.

<?php
$secret            = "YOUR_WEBHOOK_SECRET";
$payload           = file_get_contents('php://input');
$signature         = $_SERVER['HTTP_X_TURKEYSMS_SIGNATURE'] ?? '';
$expectedSignature = hash_hmac('sha256', $payload, $secret);

if (hash_equals($expectedSignature, $signature)) {
    $data = json_decode($payload, true);
    // Process delivery report
    file_put_contents('webhook_log.txt', $data['data']['sms_id'] . ": " . $data['data']['status']);
    http_response_code(200);
} else {
    http_response_code(403); // Reject unauthorized requests
}
?>

Ready-to-use solutions for the world's most popular platforms to simplify your integration process.

Integrate TurkeySMS natively into your Make.com (formerly Integromat) scenarios. Automate communication workflows without writing a single line of code.

Available Modules

• Send Single SMS: Automate notifications, alerts, and marketing.
• Send OTP: Fast delivery for verification codes.
• Check Balance: Monitor your credits in real-time.
• Auth Connection: Securely enter your API key once across all scenarios.

Setup Steps

1. In your Make.com scenario, add the TurkeySMS module.
2. Click Add Connection and name it (e.g., "My TurkeySMS Account").
3. Paste your API Key from your TurkeySMS Panel.
4. Configure your module parameters and start automating!

Fully documented SDKs for the most popular programming environments. All support Instant SMS, OTP, Scheduled Messaging, and Bulk SMS.

Every operation returns a status code. Use this table to diagnose issues and handle errors gracefully.