S
Samva
S
Samva
DashboardAPISamva DocumentationQuickstart GuideAuthentication

Api referenceWhatsapp

Send WhatsApp Message

POST
/whatsapp/send

Authorization

apiKey
X-API-Key<token>

API key for authentication

In: header

Request Body

application/json

to*string

Recipient phone number in E.164 format

Match^\+\d{10,15}$
textContent?string

WhatsApp message text content

Length1 <= length <= 4096
mediaUrl?string

URL of media to send (image, video, audio, document)

Formaturi
mediaType?unknown

Type of media being sent

Value in"image" | "video" | "audio" | "document" | "sticker"
templateId?string

Template ID to use for this message

Formatuuid
templateCategory?unknown

Template category for 2025 pricing model (required for template messages)

Value in"marketing" | "authentication" | "utility" | "service"
templateData?

Template variables

Response Body

application/json

curl -X POST "https://samva.app/api/v1/whatsapp/send" \  -H "Content-Type: application/json" \  -d '{    "to": "string"  }'
{
  "id": "string",
  "status": "pending"
}
curl -X POST "https://samva.app/api/v1/whatsapp/send" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "string"
  }'