Templates
Seus templates, do editor ou do seu código
Leia os templates que seu time cria nos editores do dashboard, ou traga o seu próprio html e gerencie-o como código: variáveis, verificação ao salvar e versões que você pode reverter.
- Comandos JSON
- Traga seu próprio html
- Variáveis
- 10 versões
- Verificado ao salvar
https://g.sendcorex.com/v1/templatetemplate:*Como funciona
Três tipos, uma API
Drag-and-drop (Unlayer), o editor da Sendcorex (Custom) e o seu próprio html são listados, lidos e renderizados do mesmo jeito.
Sem ficar preso a um editor
Fez seu email com MJML, React Email ou um designer? Envie o html. Ele é verificado ao salvar com as mesmas regras do envio, então um template que salva é um template que envia.
Versões incluídas
Cada alteração de um template html salva uma versão. Um deploy ruim está a um Restore Template Version de ser corrigido.
Primeiros passos
Só a key é necessária antes da sua primeira requisição.
- 1
Crie uma API key com escopos de template
No dashboard, abra Developers → API Keys e dê à key template:read, mais template:create, template:update e template:delete se ela gerenciar o seu próprio html.
O token do webmail não funciona aqui. Esta API usa a API key do dashboard.
- 2
Salve seu html
Create Template com um nome e o html. Use {{variables}} para o que muda em cada email.
- 3
Renderize e envie
Render Template preenche as variáveis e diz quais estão faltando. Passe o resultado para o Send Email.
O template
Get Template, Create Template e Update Template retornam este formato. List Templates o retorna sem subject, html e text.
{
"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"
}template_idhtml_<uuid>, unlayer_<number> ou custom_<uuid>. O prefixo é o tipo.
editabletrue para o seu próprio html. Templates dos editores são somente leitura pela API.
{{variables}}Placeholders no assunto, no html e no texto, preenchidos pelo Render Template.
previewUma imagem dos templates dos editores, para o seu próprio seletor de templates. null para templates html.
Sua primeira requisição
Salve um email de boas-vindas com duas variáveis. Substitua SENDCOREX_API_KEY pela sua API key.
curl -X POST 'https://g.sendcorex.com/v1/template' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "create_template", "args": { "name": "Welcome email", "subject": "Welcome, {{first_name}}", "html": "<h1>Hi {{first_name}}</h1><p>Your {{plan}} plan is ready.</p>" } }
]
}'Você recebe o template de volta com o template_id dele. Renderize-o com variáveis para ver o email final. A mesma requisição em 8 linguagens está em Create Template.
Tarefas comuns
Templates como código
Mantenha o html no seu repositório e envie-o com Update Template a cada deploy. Revisado como qualquer mudança.
Mantendo templates no seu repositórioDesfaça uma alteração ruim
Liste as versões e restaure a última boa. A restauração também é uma versão, então pode ser desfeita.
Restore Template VersionUse o que seu time desenha
O marketing monta o email no editor; seu código o lê com Get Template e o envia.
Get TemplateDetecte dados faltando
missing_variables lista toda {{variable}} que você não preencheu. Confira antes de enviar.
VariáveisReferência completa
Tudo marcado como CMD é um comando enviado por POST /v1/template, up to 10 per request.