> ## Documentation Index > Fetch the complete documentation index at: https://docs.axelo.mx/llms.txt > Use this file to discover all available pages before exploring further. # Enviar Email > POST /v1/send/email — Encola un email transaccional para su entrega. ## Endpoint ``` POST /v1/send/email ``` ## Headers | Header | Valor | | -------------- | ------------------ | | `X-API-Key` | Tu API key | | `Content-Type` | `application/json` | ## Body Debes enviar **`template_id`** (plantilla registrada) **o** **`html`** (HTML crudo inline), no ambos. ```json theme={null} { "to_address": "usuario@ejemplo.com", "to_name": "Nombre Apellido", "subject": "Asunto opcional con {{.variable}}", "template_id": "nombre-de-plantilla", "data": { "variable": "valor", "otra": "valor2" } } ``` ### Campos | Campo | Tipo | Requerido | Descripción | | ------------- | ------ | ----------- | -------------------------------------------------------------------------------------------------- | | `to_address` | string | ✅ | Dirección de email destino | | `to_name` | string | — | Nombre del destinatario (aparece en el "Para:") | | `subject` | string | — | Asunto del email. Soporta variables `{{.var}}`. Si se omite, usa el subject de la plantilla | | `template_id` | string | Condicional | ID de la plantilla HTML registrada en el dashboard. Requerido si no envías `html` | | `html` | string | Condicional | HTML crudo inline (alternativa a `template_id`). Requiere el permiso `allow_raw_html` en tu tenant | | `data` | object | — | Mapa de variables para inyectar en la plantilla/HTML y el subject | ## HTML inline En lugar de una plantilla registrada puedes enviar el HTML completo en el campo `html`. Esta capacidad está controlada por tu proveedor (permiso `allow_raw_html`) por su impacto en la reputación de entrega, y pasa por validaciones automáticas: * **Permiso**: si tu tenant no tiene `allow_raw_html`, la petición responde `403`. * **Heurísticas de contenido**: HTML vacío, demasiado grande, solo-imagen o con `