curl --request POST \
  --url https://tawked.com/v1/whatsapp/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "<string>",
  "template": "<string>",
  "lang": "<string>",
  "params": {},
  "header": {},
  "buttons": "<array>",
  "reference": "<string>",
  "application": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    to: '<string>',
    template: '<string>',
    lang: '<string>',
    params: {},
    header: {},
    buttons: '<array>',
    reference: '<string>',
    application: '<string>'
  })
};

fetch('https://tawked.com/v1/whatsapp/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?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>',
    'application' => '<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

url = "https://tawked.com/v1/whatsapp/messages"

payload = {
    "to": "<string>",
    "template": "<string>",
    "lang": "<string>",
    "params": {},
    "header": {},
    "buttons": "<array>",
    "reference": "<string>",
    "application": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "0f4c9c0e-6d2b-4b8a-9c3e-7a1d2e3f4a5b",
  "status": "accepted",
  "to": "+966550000000",
  "template": "order_received_v1",
  "lang": "ar",
  "reference": "order-1042",
  "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"
}