TurkeySMS API · V4
Developer Documentation
A JSON/REST API for SMS, OTP and bulk messaging. From test to production with a single api_key — send your first message in minutes.
Core
Quickstart
Send your first SMS in minutes. Get an API key, make the call, read the response.
Authentication
Requests are authenticated with the api_key in the JSON body. Key management and security.
Send SMS
Send an SMS to a single recipient. Parameters, response shape, and scheduled delivery.
Send OTP
One-time password delivery — standard and custom template.
Bulk SMS
Dispatch to many recipients — same text or personalized.
Queries
Balance, SenderID, message status, and reporting endpoints.
Webhooks
Receive delivery events on your server in real time. HMAC signing, events, and retries.
Reference
Response Codes
Every operation returns a stable TS-#### code. The most common codes.
Delivery Lifecycle
The states a message passes through and the valid transitions between them.
Reliability
Idempotency, rate limits, and retry behaviour.
Billing
When the balance is debited, and protection against double charging.
Versioning
API generation, backward-compatibility rules, and the deprecation policy.
n8n Community Node
SMS, OTP, and balance operations from n8n workflows. Installation and endpoint mapping.