Templates: Edição
Criar template
Salva o seu próprio html como template: de MJML, React Email, do seu designer ou de qualquer ferramenta. Ele aparece no dashboard ao lado dos templates dos editores.
https://g.sendcorex.com/v1/templatecommand: create_templateRequer o escopo template:create na sua API key.
Até 30 chamadas por minuto por conta. Acima disso, o comando responde RATE_LIMITED.
O html é verificado quando você salva, com as mesmas regras do envio: você descobre agora, não quando um email é recusado.
A primeira versão é salva junto. Veja List Template Versions.
Argumentos
namestringobrigatórioAté 255 caracteres, sem HTML.
ex.:
"Welcome email"htmlstringobrigatórioO html completo, até 512 KB. Use
{{variables}}para o que muda em cada email.ex.:
"<!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>"textstringopcionalA versão em texto puro.
ex.:
"Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"subjectstringopcionalUm assunto padrão. Pode ter variáveis.
ex.:
"Welcome to Acme, {{first_name}}"
Início rápido
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);Resposta
{
"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"
}
}
]
}Campos da resposta
template_idO id do template:
html_<uuid>,unlayer_<number>oucustom_<uuid>. Use-o em todos os outros comandos.typehtml(seu, enviado pela API),unlayer(criado no editor drag-and-drop) oucustom(criado no editor da Sendcorex).nameO nome que você deu a ele.
referenceUm código curto que também identifica o template no dashboard.
previewUma imagem do template, para templates dos editores.
nullpara templates html e para templates dos editores ainda não salvos.has_htmlfalsepara um template de editor que foi criado mas nunca salvo. Ele ainda não pode ser renderizado nem enviado.html_sizeTamanho do html, em bytes.
editabletruepara templates html: você pode atualizá-los, restaurá-los e excluí-los aqui. Templates dos editores são somente leitura pela API.created_at / updated_atISO 8601, UTC.
subjectO assunto padrão, ou
null. Pode ter variáveis.htmlO html.
nullpara um template de editor que nunca foi salvo.textA versão em texto puro, ou
null. Envie uma: alguns clientes e filtros preferem emails que a têm.
Variáveis
SintaxeEscreva
{{name}}em qualquer lugar do assunto, html ou texto. Espaços dentro das chaves não têm problema:{{ name }}. Os nomes usam letras, dígitos,_,.e-.No htmlOs valores são escapados como HTML: um valor com
<ou&nunca quebra seu layout nem injeta marcação.No assunto e no textoOs valores entram como são.
Valores faltandoUma variável que você não enviou fica como
{{name}}e é listada emmissing_variables. Confira antes de enviar.
O que o html pode ter
PermitidoTudo o que os clientes de email renderizam: tabelas, estilos inline, blocos
<style>, imagens por URL, links.Recusado<script>,<iframe>,<form>,<input>,<button>,<embed>,<object>,<svg>inline,<base>, handlerson*=e URLsjavascript:. Use um<a>estilizado em vez de um botão.ImagensHospede-as e use links. Imagens base64 embutidas deixam o html pesado e costumam ser cortadas pelo Gmail depois de ~100 KB.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
INVALID_API_KEYA API key não existe, foi revogada ou foi desativada no dashboard.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.
- CMD
MISSING_SCOPEA API key não tem o escopo de que este comando precisa.
- CMD
INVALID_ARGSUm argumento é inválido: um `template_id` malformado, `name` ou `html` ausente, um nome com mais de 255 caracteres, um `version_at` que não é RFC 3339…
- CMD
UNSAFE_HTMLO html tem algo que um email não pode carregar: `<script>`, `<iframe>`, formulários, handlers `on*=`, links `javascript:`… A mensagem diz exatamente o que remover.
- CMD
TEMPLATE_TOO_LARGEO html tem mais de 512 KB. Hospede suas imagens e use links em vez de embuti-las.
- CMD
RATE_LIMITEDEste comando foi chamado vezes demais no último minuto pela sua conta. Aguarde um minuto.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.