curl -X POST https://tawked.com/v1/whatsapp/messages \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-30517-received" \
  -d '{
    "to": "0550000000",
    "template": "order_received",
    "lang": "ar",
    "params": {
        "customer_name": "سارة",
        "order_number": "30517"
    },
    "reference": "order-30517"
}'

const res = await fetch("https://tawked.com/v1/whatsapp/messages", {
  method: "POST",
  headers: {
    Authorization: "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
    "Idempotency-Key": "order-30517-received",
  },
  body: JSON.stringify({
      "to": "0550000000",
      "template": "order_received",
      "lang": "ar",
      "params": {
          "customer_name": "سارة",
          "order_number": "30517"
      },
      "reference": "order-30517"
  }),
});
const data = await res.json();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tawked.com/v1/whatsapp/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'to' => '<string>',
    'template' => '<string>',
    'lang' => '<string>',
    'params' => [
        
    ],
    'header' => [
        
    ],
    'buttons' => '<array>',
    'reference' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

res = requests.post(
    "https://tawked.com/v1/whatsapp/messages",
    headers={"Authorization": "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx", "Idempotency-Key": "order-30517-received"},
    json={
        "to": "0550000000",
        "template": "order_received",
        "lang": "ar",
        "params": {
            "customer_name": "سارة",
            "order_number": "30517"
        },
        "reference": "order-30517"
    },
)
data = res.json()

{
  "id": "0f4c9c0e-6d2b-4b8a-9c3e-7a1d2e3f4a5b",
  "status": "accepted",
  "to": "+966550000000",
  "template": "order_received",
  "lang": "ar",
  "reference": "order-30517",
  "price_halalas": 0,
  "created_at": "2026-09-06T12:00:00+03:00"
}

{
  "error": "service_required"
}

{
  "error": "unauthorized"
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits",
  "balance_halalas": 0,
  "price_halalas": 9
}

{
  "error": "account_not_active"
}

{
  "error": "service_not_found"
}

{
  "error": "no_whatsapp_number"
}

{
  "error": "unknown_template"
}

{
  "error": "too_many_requests"
}

{
  "error": "internal_error"
}

{
  "error": "send_failed"
}

{
  "error": "templates_unavailable"
}