API Reference

Integration documentation for TumaSend — SMS, WhatsApp, Email & OTP

Base URL
https://gateway.tumasend.com

All endpoints are relative to this URL

Authentication modes

Integration mode

Used by your servers when sending SMS, WhatsApp, Email, or OTP. Pass an API key in the header.

Header:x-api-key: YOUR_KEY

Dashboard mode

Used by the frontend app. Combines a system key with a platform session token — handled automatically by the dashboard.

Required headers (Integration mode)

x-api-keylc5f3a9_abc123…Your API key — bound to one asset (Sender ID, WhatsApp Number, Email Domain, or OTP Service)
Content-Typeapplication/jsonRequired on POST requests with a body

Endpoint index

Click the copy icon to copy the full URL

POST/api/v1/send/sms
POST/api/v1/send/whatsapp
POST/api/v1/send/email
POST/api/v1/otp/send
POST/api/v1/otp/verify
GET/api/v1/batches
GET/api/v1/batches/:id/messages
GET/api/v1/analytics/overview
GET/api/v1/balance
TumaSend API · tumasend.mw