curl -X POST https://tawked.com/v1/email/messages \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-confirmation" \
  -d '{
    "from": {
        "name": "متجر أكمي",
        "address": "orders@acme.sa"
    },
    "to": "customer@example.com",
    "subject": "طلبك رقم 1042 قيد التجهيز",
    "html": "<p>مرحبًا سارة،</p><p>استلمنا طلبك رقم 1042 وهو قيد التجهيز الآن.</p>",
    "text": "مرحبًا سارة،\nاستلمنا طلبك رقم 1042 وهو قيد التجهيز الآن.",
    "reply_to": "support@acme.sa",
    "reference": "order-1042"
}'

const res = await fetch("https://tawked.com/v1/email/messages", {
  method: "POST",
  headers: {
    Authorization: "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
    "Idempotency-Key": "order-1042-confirmation",
  },
  body: JSON.stringify({
      "from": {
          "name": "متجر أكمي",
          "address": "orders@acme.sa"
      },
      "to": "customer@example.com",
      "subject": "طلبك رقم 1042 قيد التجهيز",
      "html": "<p>مرحبًا سارة،</p><p>استلمنا طلبك رقم 1042 وهو قيد التجهيز الآن.</p>",
      "text": "مرحبًا سارة،\nاستلمنا طلبك رقم 1042 وهو قيد التجهيز الآن.",
      "reply_to": "support@acme.sa",
      "reference": "order-1042"
  }),
});
const data = await res.json();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tawked.com/v1/email/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>',
    'subject' => '<string>',
    'from' => [
        
    ],
    'html' => '<string>',
    'text' => '<string>',
    'reply_to' => '<string>',
    '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/email/messages",
    headers={"Authorization": "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx", "Idempotency-Key": "order-1042-confirmation"},
    json={
        "from": {
            "name": "متجر أكمي",
            "address": "orders@acme.sa"
        },
        "to": "customer@example.com",
        "subject": "طلبك رقم 1042 قيد التجهيز",
        "html": "<p>مرحبًا سارة،</p><p>استلمنا طلبك رقم 1042 وهو قيد التجهيز الآن.</p>",
        "text": "مرحبًا سارة،\nاستلمنا طلبك رقم 1042 وهو قيد التجهيز الآن.",
        "reply_to": "support@acme.sa",
        "reference": "order-1042"
    },
)
data = res.json()

{
  "id": "3d9a7f2e-1c4b-4e8a-9f6d-2b5c8e1a7d40",
  "status": "accepted",
  "from": {
    "name": "متجر أكمي",
    "address": "orders@acme.sa"
  },
  "to": "customer@example.com",
  "subject": "طلبك رقم 1042 قيد التجهيز",
  "reference": "order-1042",
  "price_halalas": 1,
  "created_at": "2026-10-09T12:00:00+03:00"
}

{
  "error": "service_required"
}

{
  "error": "unauthorized"
}

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

{
  "error": "live_key_required"
}

{
  "error": "service_not_found"
}

{
  "error": "no_verified_domain"
}

{
  "error": "message_too_large"
}

{
  "error": "sender_not_verified"
}

{
  "error": "daily_cap_reached"
}

{
  "error": "internal_error"
}

{
  "error": "send_failed"
}

{
  "error": "email_paused"
}