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
POSThttps://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. 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. 2

    Salve seu html

    Create Template com um nome e o html. Use {{variables}} para o que muda em cada email.

  3. 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_id

html_<uuid>, unlayer_<number> ou custom_<uuid>. O prefixo é o tipo.

editable

true 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.

preview

Uma 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ório

Desfaç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 Version

Use o que seu time desenha

O marketing monta o email no editor; seu código o lê com Get Template e o envia.

Get Template

Detecte dados faltando

missing_variables lista toda {{variable}} que você não preencheu. Confira antes de enviar.

Variáveis

Referência completa

Tudo marcado como CMD é um comando enviado por POST /v1/template, up to 10 per request.