Send Templates

Send an approved template message to a single recipient, or to a small batch at once.

Endpoint

POST https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/messages

Request body

string | string[]

required

A single E.164 number, or an array of up to 100 numbers.

string

required

Must be template for this use case.

object

required

Show properties

Response

A single recipient returns one message object. Multiple recipients return a batch summary plus a per-recipient results array — there’s no separate polling endpoint; the message_id in each result is what you look up via GET /v1/messages/{message_id}.

curl https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/messages \
  -H "Authorization: Bearer tvk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919876543210",
    "type": "template",
    "template": {
      "name": "order_shipped",
      "language": "en",
      "variables": ["Priya", "#4821", "July 16"]
    }
  }'

curl https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/messages -H "Authorization: Bearer tvk_live_xxxxxxxxxxxxxxxx" -H "Content-Type: application/json" -d "{ \"to\": \"+919876543210\", \"type\": \"template\", \"template\": { \"name\": \"order_shipped\", \"language\": \"en\", \"variables\": [\"Priya\", \"#4821\", \"July 16\"] } }"

$headers = @{ "Authorization" = "Bearer tvk_live_xxxxxxxxxxxxxxxx" }
$body = @{
  to       = "+919876543210"
  type     = "template"
  template = @{ name = "order_shipped"; language = "en"; variables = @("Priya", "#4821", "July 16") }
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/messages" -Method Post -Headers $headers -ContentType "application/json" -Body $body

curl https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/messages \
  -H "Authorization: Bearer tvk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["+919876543210", "+919812345678"],
    "type": "template",
    "template": { "name": "festive_offer", "language": "en", "variables": ["Priya"] }
  }'

curl https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/messages -H "Authorization: Bearer tvk_live_xxxxxxxxxxxxxxxx" -H "Content-Type: application/json" -d "{ \"to\": [\"+919876543210\", \"+919812345678\"], \"type\": \"template\", \"template\": { \"name\": \"festive_offer\", \"language\": \"en\", \"variables\": [\"Priya\"] } }"

$headers = @{ "Authorization" = "Bearer tvk_live_xxxxxxxxxxxxxxxx" }
$body = @{
  to       = @("+919876543210", "+919812345678")
  type     = "template"
  template = @{ name = "festive_offer"; language = "en"; variables = @("Priya") }
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/messages" -Method Post -Headers $headers -ContentType "application/json" -Body $body

Not sure which Windows tab to use? The two aren’t interchangeable — pasting one into the wrong shell fails with a ... is not recognized error. Use CMD only in classic Command Prompt. Use PowerShell if your terminal is PowerShell, Windows Terminal, or VS Code’s integrated terminal — the default on most modern Windows setups. The PowerShell example uses Invoke-RestMethod rather than curl.exe to avoid PowerShell’s known issues passing complex quoted JSON to external executables.

Response (single)

{
  "message_id": "5a9e6f1c-9e2f-4b1c-8a5c-7e8f9a0b1c2d",
  "status": "accepted"
}

Response (batch)

{
  "batch_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "recipient_count": 2,
  "failed_count": 0,
  "status": "queued",
  "results": [
    { "to": "+919876543210", "ok": true, "message_id": "5a9e6f1c-9e2f-4b1c-8a5c-7e8f9a0b1c2d" },
    { "to": "+919812345678", "ok": true, "message_id": "8b2d4e5f-1a3b-4c5d-9e6f-7a8b9c0d1e2f" }
  ]
}

This endpoint sends recipients concurrently, not through the wave-throttled broadcast engine the dashboard uses. It’s built for small, immediate sends (confirmations, alerts) — for anything larger than 100 recipients, use the dashboard’s broadcast tool, which paces sends properly for large audiences.

There’s no batch_id lookup endpoint yet — track individual sends via the results array’s message_ids, or via the message.status webhook.

Guides

WhatsApp

Claude / MCP

Endpoint

Request body

Response

​Endpoint

​Request body

​Response

Endpoint

Request body

Response