SMSKit Documentation
Send your first SMS in five minutes. Everything you need to integrate, in one place.
Quickstart
Pair a phone, send your first SMS.
Authentication
API keys and rotation.
API reference
Every endpoint.
Webhooks
Real-time events.
Two-way messaging
Receive and thread replies.
SDKs & samples
.NET SDK + 6-language snippets.
Device & SIM setup
Pairing, multi-SIM, battery.
Errors & rate limits
Status codes and backoff.
Quickstart
Three steps. Five minutes.
1. Create an account & API key
Sign up, open API Clients in the dashboard, and create a client. Copy the
key (sk_live_…) — it's shown once.
2. Pair a phone
Install the SMSKit Gateway app (download), open Devices in the dashboard, and scan the pairing code. Your phone is now online.
3. Send your first SMS
curl https://api.smskit.cloud/api/sms/send \
-H "X-Api-Key: sk_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"recipient": "+254712345678",
"message": "Hello from SMSKit"
}'You get back a job id:
{ "jobId": "job_7H2K9M4P1Q6R3T8V5W0X", "status": "Pending" }Poll the job status or subscribe to webhooks to
follow it to Delivered.
Authentication
Every API request is authenticated with an API client key in the X-Api-Key header.
X-Api-Key: sk_live_your_api_client_key_here...- • Keys are created on the dashboard API Clients page. The raw key is shown once.
- • Keys are stored as SHA-256 hashes; we can't recover a lost key — rotate instead.
- • A suspended API client rejects its keys with 401.
Two keys, zero-downtime rotation
Each API client has two independent key slots — Key 1 and Key 2. Either authenticates. To rotate without downtime: run on Key 1 → rotate Key 2 and deploy it → rotate Key 1. No request ever fails.