Concepto

Versiones de plantilla

Las versiones comparten un alias para que puedas preparar, probar y publicar un diseño nuevo sin cambiar el código. Cómo funciona la publicación en el panel y en la API.

Actualizado el 1 oct 2026

Las versiones te permiten cambiar una plantilla sin tocar el código que la envía. Todas las versiones de una plantilla comparten un alias, y como máximo una de ellas está publicada. Los envíos por alias usan siempre la versión publicada, así que puedes preparar un rediseño, probarlo y pasar a él con un solo clic.

Cómo funcionan las versiones

Cada plantilla es una versión con su propio ID tem_, su nombre, su asunto, su dirección del remitente, su editor y su contenido. Las versiones con el mismo alias forman un grupo:

Text

welcome-email
├── Welcome email v3   tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh   Draft
├── Welcome email v2   tem_33Vd8Hq3Ws5NzK1xR7cM2pLbYte   Published   ← sends by alias use this one
└── Welcome email      tem_33TfB6yN4qJ8kV2mX9wR1cHsDua   Draft

Cómo haces referencia a la plantilla	Qué versión se usa
Por alias, como `"template": "welcome-email"`	La versión publicada. Si no hay ninguna publicada, el envío falla con `404 Template not found`.
Por ID `tem_`, como `"template": "tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh"`	Esa versión exacta, esté publicada o no

Las mismas reglas se aplican al paso Send email de las automatizaciones. En el panel, la lista de plantillas solo muestra la versión publicada de cada alias. Los borradores aparecen en el panel Versions de la página de la plantilla.

Crear una versión nueva

Abre la plantilla. Ve a Email MarketingTemplates y selecciona la plantilla.
Empieza una versión. En el panel Versions, selecciona New Version.
Elige el origen. En el cuadro de diálogo Create New Version, elige en Copy from la versión de la que quieres partir y selecciona Create Version. Emailit copia su asunto, su From, su Reply-To, su editor y su contenido en un borrador nuevo con el nombre del origen, como Welcome email v3.
Edita el borrador. Selecciona Open Editor y haz tus cambios. La versión publicada se sigue enviando hasta que publiques el borrador.

También se crea una versión nueva cada vez que añades una plantilla con un alias que ya existe, ya sea con Add template, Duplicate Template, Import o Save as template en una campaña. La plantilla nueva se guarda como borrador. Los cuadros de diálogo Add template, Duplicate Template y Save as template te avisan con Alias already exists; Import, no.

Probar un borrador

Envíate el borrador por su ID tem_ antes de publicarlo. Copia el ID de la página de la plantilla.

Terminal

curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "you@acme.com",
    "template": "tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh",
    "variables": { "first_name": "Ada", "plan": "Pro" }
  }'

Publicar una versión

Publicar una versión la convierte en la versión activa de su alias. La versión que estaba publicada pasa a ser un borrador, así que nunca hay más de una versión publicada.

Abre el borrador y selecciona Publish, o selecciona el icono de publicar que tiene al lado en el panel Versions. El cuadro de diálogo Publish template avisa de que la publicación sustituirá a la versión activa actual. Selecciona Publish para confirmar.

Llama a Publicar una plantilla (POST /templates/{id}/publish) con el ID tem_ de la versión y una clave Full Access.

Terminal

curl -X POST https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JavaScript

const res = await fetch(
  'https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish',
  { method: 'POST', headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}` } },
);
const { data } = await res.json();

Python

import os
import requests

res = requests.post(
    "https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
)
template = res.json()["data"]

PHP

$ch = curl_init('https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('EMAILIT_API_KEY')],
]);
$template = json_decode(curl_exec($ch), true)['data'];

La publicación emite template.updated para la versión recién publicada y para la versión que se ha despublicado. Para volver atrás, publica de nuevo la versión anterior.

Editar o eliminar una versión publicada

Los cambios se aplican de inmediato. Al guardar cambios en la versión publicada, cambia desde ese momento lo que usan los envíos por alias. El editor Dragit guarda automáticamente mientras trabajas, así que sus cambios se aplican a medida que los haces. Para preparar cambios sin aplicarlos, crea una versión nueva.
Eliminar no publica otra versión. Si eliminas la versión publicada, el alias se queda sin versión publicada, y los envíos y las automatizaciones que usan el alias fallan hasta que publiques otra. Al eliminar, solo se borra esa versión; las demás se conservan.

Versiones en la API

Acción	Comportamiento
Crear una plantilla con un alias nuevo	La plantilla se publica automáticamente.
Crear una plantilla con un alias existente	La plantilla se crea como una versión sin publicar, con `published_at` a `null`.
Listar plantillas	Devuelve solo las versiones publicadas, una por alias, cada una con `total_versions`.
Obtener una plantilla	Devuelve la versión y además `versions`: las demás versiones del alias con su `id`, `name`, `published_at`, `created_at` y `updated_at`, de la más reciente a la más antigua.
Actualizar una plantilla	Cambia los campos de la versión sin cambiar si está publicada o no. Cambiar el alias por uno que ya está en uso falla con `Alias already exists`.
Publicar una plantilla	Publica esta versión y despublica todas las demás versiones del alias.
Eliminar una plantilla	Elimina solo esta versión.