Quickstart

Send your first WhatsApp message in a few minutes.

Get your API key

Go to Settings → API Keys in your Tanvik dashboard and generate a key (tvk_live_...). It’s shown once — store it somewhere safe.

Send a message

macOS/Linux
Windows (CMD)
Windows (PowerShell)

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": "text", "text": "Hello from Tanvik!" }'

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\": \"text\", \"text\": \"Hello from Tanvik!\" }"

$headers = @{ "Authorization" = "Bearer tvk_live_xxxxxxxxxxxxxxxx" }
$body = @{ to = "+919876543210"; type = "text"; text = "Hello from Tanvik!" } | ConvertTo-Json
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. Use CMD only in classic Command Prompt (opened via cmd or “Command Prompt” in the Start menu). Use PowerShell if your terminal is PowerShell, Windows Terminal, or the integrated terminal in VS Code — this is the default on most modern Windows setups, so if you’re unsure, start there. The PowerShell example uses Invoke-RestMethod (PowerShell’s built-in HTTP cmdlet) rather than curl.exe, since passing complex quoted JSON to an external executable can get mangled by PowerShell’s argument parsing — Invoke-RestMethod avoids that entirely.

This only works within an open 24-hour session (i.e. the customer has messaged you recently). To message someone cold, use an approved template instead — see step 3.

Send a template

macOS/Linux
Windows (CMD)
Windows (PowerShell)

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": "your_approved_template", "language": "en", "variables": [] }
  }'

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\": \"your_approved_template\", \"language\": \"en\", \"variables\": [] } }"

$headers = @{ "Authorization" = "Bearer tvk_live_xxxxxxxxxxxxxxxx" }
$body = @{
  to       = "+919876543210"
  type     = "template"
  template = @{ name = "your_approved_template"; language = "en"; variables = @() }
} | 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

CMD and PowerShell syntax aren’t interchangeable. The PowerShell example uses Invoke-RestMethod rather than curl.exe to avoid PowerShell’s known issues passing complex quoted JSON to external executables.

See Create Templates if you don’t have an approved template yet.

Try an OTP

macOS/Linux
Windows (CMD)
Windows (PowerShell)

curl https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/otp/send \
  -H "Authorization: Bearer tvk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+919876543210" }'

curl https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/otp/send -H "Authorization: Bearer tvk_live_xxxxxxxxxxxxxxxx" -H "Content-Type: application/json" -d "{ \"to\": \"+919876543210\" }"

$headers = @{ "Authorization" = "Bearer tvk_live_xxxxxxxxxxxxxxxx" }
$body = @{ to = "+919876543210" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/otp/send" -Method Post -Headers $headers -ContentType "application/json" -Body $body

Requires an approved authentication-category template on your account — see Send OTP for the full reference.

Subscribe to delivery status and inbound messages so you don’t have to poll:

macOS/Linux
Windows (CMD)
Windows (PowerShell)

curl https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/webhooks \
  -H "Authorization: Bearer tvk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://yourapp.com/webhooks/tanvik", "events": ["message.received", "message.status"] }'

curl https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/webhooks -H "Authorization: Bearer tvk_live_xxxxxxxxxxxxxxxx" -H "Content-Type: application/json" -d "{ \"url\": \"https://yourapp.com/webhooks/tanvik\", \"events\": [\"message.received\", \"message.status\"] }"

$headers = @{ "Authorization" = "Bearer tvk_live_xxxxxxxxxxxxxxxx" }
$body = @{ url = "https://yourapp.com/webhooks/tanvik"; events = @("message.received", "message.status") } | ConvertTo-Json
Invoke-RestMethod -Uri "https://xwialxkobwygraiddimj.supabase.co/functions/v1/public-api/v1/webhooks" -Method Post -Headers $headers -ContentType "application/json" -Body $body

See Webhooks for signature verification and retry behavior.

Next steps

Authentication

Key scoping and rotation.

Send Templates

Send to up to 100 recipients at once.

Conversation API

Free-form replies within the 24-hour window.

Errors

Error codes and how to handle them.

Guides

WhatsApp

Claude / MCP

Next steps

Authentication

Send Templates

Conversation API

Errors

​Next steps

Authentication

Send Templates

Conversation API

Errors

Next steps