Templates: Mengedit

Buat template

Menyimpan html Anda sendiri sebagai template: dari MJML, React Email, desainer Anda, atau alat apa pun. Template ini muncul di dashboard di samping template dari editor.

POSThttps://g.sendcorex.com/v1/templatecommand: create_template
i

Membutuhkan scope template:create pada API key Anda.

i

Hingga 30 panggilan per menit per akun. Jika lebih, perintah menjawab RATE_LIMITED.

i

html diperiksa saat Anda menyimpan, dengan aturan yang sama seperti saat mengirim: Anda tahu sekarang, bukan saat email ditolak.

i

Versi pertama ikut disimpan. Lihat List Template Versions.

Argumen

  • namestringwajib

    Hingga 255 karakter, tanpa HTML.

    mis. "Welcome email"

  • htmlstringwajib

    html lengkap, hingga 512 KB. Gunakan {{variables}} untuk bagian yang berubah per email.

    mis. "<!doctype html><html><body style=\"font-family:Arial,sans-serif\"><h1>Welcome, {{first_name}}!</h1><p>Your {{plan}} plan is ready.</p><p><a href=\"https://acme.com/start\">Get started</a></p></body></html>"

  • textstringopsional

    Versi teks biasa.

    mis. "Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"

  • subjectstringopsional

    Subjek default. Bisa berisi variabel.

    mis. "Welcome to Acme, {{first_name}}"

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/template',
  {
    commands: [
      {
        command: "create_template",
        args: {
          name: "Welcome email",
          subject: "Welcome to Acme, {{first_name}}",
          html: "<!doctype html><html><body style=\"font-family:Arial,sans-serif\"><h1>Welcome, {{first_name}}!</h1><p>Your {{plan}} plan is ready.</p><p><a href=\"https://acme.com/start\">Get started</a></p></body></html>",
          text: "Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Respons

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "create_template",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 9,
      "data": {
        "template_id": "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
        "type": "html",
        "name": "Welcome email",
        "reference": "K7Q2M9XR4T",
        "preview": null,
        "has_html": true,
        "html_size": 248,
        "editable": true,
        "created_at": "2026-10-21T04:02:11.310Z",
        "updated_at": "2026-10-21T04:15:40.902Z",
        "subject": "Welcome to Acme, {{first_name}}",
        "html": "<!doctype html><html><body style=\"font-family:Arial,sans-serif\"><h1>Welcome, {{first_name}}!</h1><p>Your {{plan}} plan is ready.</p><p><a href=\"https://acme.com/start\">Get started</a></p></body></html>",
        "text": "Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"
      }
    }
  ]
}

Field respons

  • template_id

    id template: html_<uuid>, unlayer_<number>, atau custom_<uuid>. Gunakan di semua perintah lain.

  • type

    html (milik Anda, dikirim lewat API), unlayer (dibuat di editor drag-and-drop), atau custom (dibuat di editor Sendcorex).

  • name

    Nama yang Anda berikan.

  • reference

    Kode pendek yang juga mengidentifikasi template di dashboard.

  • preview

    Gambar template, untuk template editor. null untuk template html dan template editor yang belum disimpan.

  • has_html

    false untuk template editor yang sudah dibuat tetapi belum pernah disimpan. Template ini belum bisa dirender atau dikirim.

  • html_size

    Ukuran html, dalam byte.

  • editable

    true untuk template html: Anda bisa memperbarui, memulihkan, dan menghapusnya di sini. Template editor hanya bisa dibaca melalui API.

  • created_at / updated_at

    ISO 8601, UTC.

  • subject

    Subjek default, atau null. Bisa berisi variabel.

  • html

    html-nya. null untuk template editor yang belum pernah disimpan.

  • text

    Versi teks biasa, atau null. Sertakan satu: beberapa klien dan filter lebih menyukai email yang memilikinya.

Variabel

  • Sintaks

    Tulis {{name}} di mana saja dalam subjek, html, atau teks. Spasi di dalam kurung kurawal tidak masalah: {{ name }}. Nama memakai huruf, angka, _, ., dan -.

  • Di html

    Nilai di-escape sebagai HTML: nilai yang mengandung < atau & tidak akan pernah merusak layout atau menyisipkan markup.

  • Di subjek dan teks

    Nilai dimasukkan apa adanya.

  • Nilai yang kurang

    Variabel yang tidak Anda kirim tetap sebagai {{name}} dan dicantumkan di missing_variables. Periksa sebelum mengirim.

Apa yang boleh ada di html

  • Diizinkan

    Apa pun yang dirender klien email: tabel, style inline, blok <style>, gambar via URL, link.

  • Ditolak

    <script>, <iframe>, <form>, <input>, <button>, <embed>, <object>, <svg> inline, <base>, handler on*=, dan URL javascript:. Gunakan <a> yang diberi style sebagai pengganti tombol.

  • Gambar

    Host gambarnya dan tautkan. Gambar base64 yang disematkan membuat html berat dan sering dipotong Gmail setelah ~100 KB.

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 401INVALID_API_KEY

    API key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.

  • 429RATE_LIMITED

    Lebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.

  • CMDMISSING_SCOPE

    API key tidak memiliki scope yang dibutuhkan perintah ini.

  • CMDINVALID_ARGS

    Ada argumen yang tidak valid: `template_id` yang salah format, `name` atau `html` tidak ada, nama lebih dari 255 karakter, `version_at` yang bukan RFC 3339…

  • CMDUNSAFE_HTML

    html berisi sesuatu yang tidak bisa dibawa email: `<script>`, `<iframe>`, formulir, handler `on*=`, link `javascript:`… Pesannya menyebutkan persis apa yang harus dihapus.

  • CMDTEMPLATE_TOO_LARGE

    html lebih dari 512 KB. Host gambar Anda dan tautkan, jangan disematkan.

  • CMDRATE_LIMITED

    Akun Anda memanggil perintah ini terlalu sering dalam satu menit terakhir. Tunggu satu menit.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.