S
Samva
S
Samva
DashboardAPISamva DocumentationQuickstart GuideAuthentication

SDKs & ToolsTypeScript SDKREST APIPostman Collection
SDKs & Tools

REST API

Direct REST API integration guide for Samva

Integrate directly with Samva's REST API for maximum flexibility and control.

Base URL

Production: https://samva.app/api/v1
Sandbox: https://staging.samva.app/api/v1

Authentication

All API requests require authentication via Bearer token:

curl -H "Authorization: Bearer sk_live_your_api_key" \
  https://samva.app/api/v1/messages

Quick Example

Send SMS

curl -X POST https://samva.app/api/v1/messages/send \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "sms",
    "to": "+919876543210",
    "content": {
      "template_id": "your_dlt_template",
      "variables": {
        "otp": "123456"
      }
    }
  }'

Response Format

{
  "id": "msg_abc123",
  "status": "queued",
  "created_at": "2024-01-15T10:30:00Z",
  "credits_used": 1
}

Documentation In Progress

Complete REST API documentation with all endpoints will be available soon.

Next Steps

  • API Reference
  • Authentication
  • Postman Collection

TypeScript SDK

Official TypeScript/JavaScript SDK for Samva API

Postman Collection

Import Samva API collection into Postman

On this page

Base URLAuthenticationQuick ExampleSend SMSResponse FormatDocumentation In ProgressNext Steps