Quick Start — Send your first SMS
# Replace sk_live_... with your API key from Settings → API Keys curl -X POST https://api.sarn.io/v1/sms \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{ "to": "+254712345678", "sender_id": "SARN", "message": "Hello! Your verification code is 123456." }'
API Modules
SMS
Send transactional and bulk SMS messages. Query delivery status and
full audit logs for every message.
sms:send | sms:read
Campaigns
Submit bulk campaigns to thousands of recipients. Supports optional
maker-checker approval workflow and real-time delivery tracking.
campaigns:send | campaigns:read
WhatsApp
Send text, image, video, document, audio and pre-approved template
messages via Meta connectors.
whatsapp:send | whatsapp:read
Webhooks
Register HTTPS endpoints to receive real-time event notifications
with HMAC-SHA256 signature verification.
webhooks:write
Account
Query your organisation profile, billing type, prepaid SMS balance,
and per-connector balance breakdown.
balance:read