curl -X POST https://tawked.com/v1/email/received/test \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxx"

const res = await fetch("https://tawked.com/v1/email/received/test", {
  method: "POST",
  headers: {
    Authorization: "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx",
  },
});
const data = await res.json();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tawked.com/v1/email/received/test",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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/test",
    headers={"Authorization": "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx"},
)
data = res.json()

{
  "id": "0199f3c0-6a7b-7c8d-9e0f-1a2b3c4d5e6f",
  "event": "email.received",
  "mode": "test",
  "deliveries": 1,
  "data": {
    "id": "0199f3c0-6a7b-7c8d-9e0f-1a2b3c4d5e6f",
    "address": {
      "id": "0199f2b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
      "domain": "acme.inbound.tawked.com",
      "kind": "hosted"
    },
    "to": [
      "test@acme.inbound.tawked.com"
    ],
    "from": {
      "name": "Sara",
      "address": "sara@example.com"
    },
    "subject": "رسالة تجربة",
    "spam": false,
    "has_attachments": false,
    "attachments_count": 0,
    "size": 2048,
    "status": "ready",
    "thread": null,
    "received_at": "2026-10-26T09:12:03+00:00",
    "envelope_from": "sara@example.com",
    "message_id": "<test-event@example.com>",
    "in_reply_to": null,
    "authentication": {
      "spf": "pass",
      "dkim": "pass",
      "dmarc": "pass",
      "dmarc_policy": null
    },
    "parse": "ready",
    "attachments": []
  }
}

{
  "error": "service_required"
}

{
  "error": "unauthorized"
}

{
  "error": "test_key_required",
  "message": "A received e-mail is simulated with a test key (tk_test_); a live key receives real mail at its addresses."
}

{
  "error": "service_not_found"
}

{
  "error": "test_mode_limit_reached"
}

{
  "error": "internal_error"
}