curl -X POST https://tawked.com/v1/email/templates \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "تم شحن الطلب",
    "alias": "order-shipped",
    "subject": "طلبك {{ ORDER }} في الطريق",
    "html": "<p>مرحبًا {{ NAME }}، طلبك {{ ORDER }} في الطريق.</p>",
    "variables": [
        {
            "key": "ORDER",
            "fallback": null
        },
        {
            "key": "NAME",
            "fallback": "عميلنا"
        }
    ],
    "publish": true
}'

const res = await fetch("https://tawked.com/v1/email/templates", {
  method: "POST",
  headers: {
    Authorization: "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      "name": "تم شحن الطلب",
      "alias": "order-shipped",
      "subject": "طلبك {{ ORDER }} في الطريق",
      "html": "<p>مرحبًا {{ NAME }}، طلبك {{ ORDER }} في الطريق.</p>",
      "variables": [
          {
              "key": "ORDER",
              "fallback": null
          },
          {
              "key": "NAME",
              "fallback": "عميلنا"
          }
      ],
      "publish": true
  }),
});
const data = await res.json();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tawked.com/v1/email/templates",
  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([
    'name' => '<string>',
    'subject' => '<string>',
    'alias' => '<string>',
    'html' => '<string>',
    'text' => '<string>',
    'from' => [
        
    ],
    'reply_to' => '<array>',
    'variables' => '<array>',
    'publish' => true
  ]),
  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/templates",
    headers={"Authorization": "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx"},
    json={
        "name": "تم شحن الطلب",
        "alias": "order-shipped",
        "subject": "طلبك {{ ORDER }} في الطريق",
        "html": "<p>مرحبًا {{ NAME }}، طلبك {{ ORDER }} في الطريق.</p>",
        "variables": [
            {
                "key": "ORDER",
                "fallback": None
            },
            {
                "key": "NAME",
                "fallback": "عميلنا"
            }
        ],
        "publish": True
    },
)
data = res.json()

{
  "id": "0199f1f0-2d3e-7f4a-8b5c-6d7e8f9a0b12",
  "alias": "order-shipped",
  "name": "تم شحن الطلب",
  "state": "published",
  "published_version": 1,
  "published": {
    "id": "0199f200-3d4e-7f5a-8b6c-7d8e9f0a1b23",
    "number": 1,
    "state": "published",
    "subject": "طلبك {{ ORDER }} في الطريق",
    "html": "<p>مرحبًا {{ NAME }}، طلبك {{ ORDER }} في الطريق.</p>",
    "text": null,
    "from": null,
    "reply_to": [],
    "variables": [
      {
        "key": "ORDER",
        "fallback": null
      },
      {
        "key": "NAME",
        "fallback": "عميلنا"
      }
    ],
    "placeholders": [
      "ORDER",
      "NAME"
    ],
    "problems": [],
    "published_at": "2026-10-23T09:00:00+00:00",
    "updated_at": "2026-10-23T09:00:00+00:00"
  },
  "draft": null,
  "created_at": "2026-10-20T09:00:00+00:00",
  "updated_at": "2026-10-23T09:00:00+00:00"
}

{
  "error": "invalid_json"
}

{
  "error": "unauthorized"
}

{
  "error": "live_key_required"
}

{
  "error": "template_alias_taken",
  "field": "alias"
}

{
  "error": "template_invalid",
  "problems": [
    {
      "code": "placeholder_undeclared",
      "key": "NAME",
      "severity": "error"
    }
  ]
}

{
  "error": "too_many_requests"
}

{
  "error": "internal_error"
}