curl -X POST https://tawked.com/v1/email/received/0199f3a1-5c2e-7d40-9a1b-2c3d4e5f6a7b/forward \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "ops@acme.sa",
    "from": "orders@acme.sa",
    "note": "للمتابعة"
}'

const res = await fetch("https://tawked.com/v1/email/received/0199f3a1-5c2e-7d40-9a1b-2c3d4e5f6a7b/forward", {
  method: "POST",
  headers: {
    Authorization: "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ to: "ops@acme.sa", from: "orders@acme.sa", note: "للمتابعة" }),
});
const data = await res.json();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tawked.com/v1/email/received/{id}/forward",
  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>',
    'from' => [
        
    ],
    'note' => '<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/received/0199f3a1-5c2e-7d40-9a1b-2c3d4e5f6a7b/forward",
    headers={"Authorization": "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx"},
    json={"to": "ops@acme.sa", "from": "orders@acme.sa", "note": "للمتابعة"},
)
data = res.json()

{
  "id": "0199f3b4-2c1d-7e5f-8a9b-0c1d2e3f4a5b",
  "status": "accepted",
  "from": {
    "name": "متجر أكمي",
    "address": "orders@acme.sa"
  },
  "to": [
    "ops@acme.sa"
  ],
  "cc": [],
  "bcc": [],
  "reply_to": [
    "sara@example.com"
  ],
  "subject": "استفسار عن الطلب 1042",
  "reference": null,
  "tags": [],
  "scheduled_at": null,
  "recipients": [
    {
      "id": "0199f3b4-2c1e-7a10-8b2c-3d4e5f6a7b8c",
      "address": "ops@acme.sa",
      "name": null,
      "type": "to",
      "status": "queued"
    }
  ],
  "price_halalas": 0,
  "cost": {
    "emails": 1,
    "suppressed": 0,
    "free": 1,
    "billed": 0,
    "halalas": "0"
  },
  "created_at": "2026-10-26T12:20:00+03:00",
  "mode": "live"
}

{
  "error": "service_required"
}

{
  "error": "unauthorized"
}

{
  "error": "insufficient_credits"
}

{
  "error": "live_key_required"
}

{
  "error": "service_not_found"
}

{
  "error": "received_not_ready",
  "message": "The received email is still being read; forward it once its status is ready."
}

{
  "error": "received_content_gone"
}

{
  "error": "forward_too_large",
  "message": "A forward carries at most 10 attachments and 10 MiB in all (a Tawked limit)."
}

{
  "error": "forward_risky_attachment",
  "message": "The email carries an attachment that could run a program; it is never forwarded."
}

{
  "error": "rate_limited"
}

{
  "error": "internal_error"
}

{
  "error": "service_unavailable"
}