Crear una plantilla

POST /api/v1/templates Crea una plantilla. Responde 201. La respuesta añade un campo a la plantilla: unsupportedTags.
json
{
  "success": true,
  "data": {
    "id": "…",
    "name": "August newsletter",
    "defaultSubject": "What shipped in August",
    "content": "…",
    "unsupportedTags": ["*|DATE:d F Y|*"],
    "createdAt": "…",
    "updatedAt": "…"
  }
}
Las etiquetas de combinación de Mailchimp se convierten al entrar. *|UNSUB|* se convierte en {{unsubscribeUrl}}, *|FNAME|* en {{firstName}}, *|CURRENT_YEAR|* en {{currentYear}}, y así sucesivamente. Una etiqueta sin equivalente se deja exactamente donde está y se enumera en unsupportedTags: te enteras mientras escribes, no cuando el email llega a una bandeja de entrada con un *|DATE:d F Y|* en bruto.

Autorización

Rol en la organizaciónEste endpoint
OWNERPermitido
ADMINPermitido
MEMBERRechazado — 403
Una clave lleva el rol que su creador tiene en esta organización, nunca un rol sobre AgentsMail en sí. Consulta Claves de API.

Cuerpo de la solicitud

CampoTipoObligatorioDescripción
namestringsíDe 1 a 100 caracteres
defaultSubjectstringsíDe 1 a 200 caracteres, lo usan las campañas que no lo sobrescriben
contentstringsíEl HTML del email

Ejemplo

bash
curl -X POST -H "x-api-key: $AGENTMAIL_API_KEY" -H "content-type: application/json" \
  -d '{
    "name": "August newsletter",
    "defaultSubject": "What shipped in August",
    "content": "<html><body><p>Hi {{firstName}}</p><a href=\"{{unsubscribeUrl}}\">Unsubscribe</a></body></html>"
  }' \
  "https://www.agentsmail.io/api/v1/templates"

Respuesta

  • 201 Created: el recurso creado.
  • 401 Unauthorized: clave ausente o no válida, o su propietario salió de la organización.
  • 403 Forbidden: el propietario de la clave es member de la organización, no admin.
  • 429 Too Many Requests: más de 120 solicitudes en un minuto para esta clave.

Campos de la respuesta

CampoTipoDescripción
successbooleanIndica si la operación se realizó correctamente
data.idstringIdentificador único de la plantilla
data.namestringNombre de la plantilla
data.defaultSubjectstringAsunto que hereda una campaña, y que puede sobrescribir
data.contentstringEl documento HTML completo
data.createdAtstringFecha de creación ISO
data.updatedAtstringFecha ISO del último cambio
data.unsupportedTagsarrayEtiquetas de Mailchimp que se dejaron intactas en tu HTML: léelo

Ejemplo de respuesta

json
{
  "success": true,
  "data": {
    "id": "4d19c0a2",
    "name": "Newsletter",
    "defaultSubject": "August news",
    "content": "<html>…</html>",
    "createdAt": "2026-08-23T10:22:05.000Z",
    "updatedAt": "2026-08-23T10:22:05.000Z",
    "unsupportedTags": []
  }
}

Relacionado