
Un cliente hace un pedido y necesita recibir una confirmación. Otro usuario solicita restablecer su contraseña, mientras que una cuenta nueva requiere un mensaje de verificación. Estos correos deben generarse a partir del evento correspondiente, sin que alguien tenga que redactarlos y enviarlos uno por uno.
Una API de correo electrónico conecta tu aplicación con un proveedor de envío para que el backend solicite esos mensajes de forma programática. Tu aplicación proporciona el destinatario y el contenido; el proveedor se encarga de la infraestructura de envío.
En esta guía veremos cómo funciona una API de email, en qué se diferencia de SMTP y cómo enviar tu primer correo transaccional con EmailMassivo mediante una solicitud cURL.
¿Qué es una API de correo electrónico?
Una API de correo electrónico es una interfaz de programación que permite a sitios web y aplicaciones solicitar el envío de mensajes a través de un proveedor de correo. Puede utilizarse para confirmaciones de pedidos, recuperación de contraseñas, verificación de cuentas, recibos y notificaciones.
API significa Application Programming Interface, o interfaz de programación de aplicaciones: una forma definida para que dos sistemas de software se comuniquen. En lugar de redactar un correo manualmente, tu aplicación envía los datos que exige el proveedor, como destinatario, remitente, asunto y contenido.
En una API REST, esta comunicación se realiza mediante solicitudes HTTP. La documentación del proveedor especifica los endpoints disponibles, el método de autenticación, los campos obligatorios y las respuestas.
Con un servicio de envío alojado no necesitas administrar tu propio servidor de correo saliente. Sin embargo, tu equipo sigue siendo responsable de la lógica de la aplicación, la configuración del remitente, las credenciales y el manejo de las respuestas.
La API automatiza la solicitud de envío, no las decisiones del negocio. No determina si un pedido es válido, no genera por sí sola un token seguro para restablecer una contraseña y no establece el permiso para enviar publicidad. Esas responsabilidades siguen en tu aplicación.
¿Cómo funciona una API de email?
Una integración conecta un evento de tu aplicación con una solicitud de envío:
Aplicación → API de email → Proveedor de envío → Destinatario
La API y el proveedor pueden formar parte del mismo servicio. El esquema representa las etapas del proceso, no necesariamente cuatro sistemas independientes.
Por ejemplo, una confirmación de pedido puede seguir esta secuencia:
- La aplicación confirma que el pedido fue registrado correctamente.
- El backend prepara el destinatario, el asunto y los datos del mensaje.
- Envía una solicitud autenticada al proveedor.
- Revisa la respuesta y conserva el identificador del correo para darle seguimiento.
Una respuesta exitosa de la API no garantiza que el correo haya llegado a la bandeja de entrada. Confirma el resultado de la solicitud en esa etapa del procesamiento.
Por eso, tu aplicación debe distinguir entre una solicitud aceptada y una entrega confirmada. Guarda el identificador devuelto y consulta la información de estado que el proveedor tenga documentada.
Si la solicitud falla, revisa el error antes de reintentar. Un token incorrecto y una interrupción temporal del servicio no requieren la misma solución.
¿Qué son los correos transaccionales?
Los correos transaccionales comunican información relacionada con una acción, una cuenta o un evento operativo. Su propósito es ayudar al destinatario a completar una tarea o entender lo que ocurrió.
Algunos ejemplos son:
- Confirmación de un pedido.
- Solicitud para restablecer una contraseña.
- Verificación de una cuenta.
- Recibo de una operación.
- Confirmación o recordatorio de una cita.
- Notificación de un cambio relevante en una cuenta.
Los correos de marketing tienen otra finalidad principal: promocionar productos, distribuir newsletters o generar interés en una oferta. Suelen organizarse alrededor de una campaña o una audiencia, no de un evento individual.
La diferencia depende del propósito del mensaje, no de que se envíe automáticamente. Una promoción programada sigue siendo comunicación de marketing; la automatización no la convierte en transaccional.
Mantén los mensajes operativos enfocados. Una confirmación debe permitir encontrar rápidamente los datos del pedido. Un correo de recuperación de contraseña debe explicar la acción solicitada sin esconderla debajo de contenido promocional.
Si necesitas una publicación periódica en lugar de una notificación vinculada con un evento, consulta nuestra guía sobre cómo crear una newsletter por correo electrónico.
API de email vs. SMTP: ¿cuál es la diferencia?
Una API de email y SMTP son dos formas de solicitar el envío de correo desde una aplicación.
SMTP significa Simple Mail Transfer Protocol. Es un protocolo de correo estandarizado, cuya especificación se describe en el RFC 5321.
Una API REST utiliza solicitudes HTTP y una estructura definida por el proveedor. SMTP utiliza comandos del protocolo de correo y normalmente se integra mediante una biblioteca o una conexión SMTP configurable.
| Aspecto | API de email | SMTP |
|---|---|---|
| Comunicación | Solicitudes HTTP a endpoints del proveedor | Protocolo SMTP |
| Datos de la solicitud | Formato definido por el proveedor; frecuentemente JSON | Mensaje de correo y comandos del protocolo |
| Autenticación | Según la documentación de la API | Según los métodos admitidos por el servidor SMTP |
| Integración | Adecuada para aplicaciones que ya utilizan servicios HTTP | Adecuada para software con soporte SMTP |
| Manejo de errores | Códigos HTTP y respuestas documentadas | Respuestas SMTP interpretadas por el cliente o biblioteca |
| Entregabilidad | No garantiza la bandeja de entrada | Tampoco garantiza la bandeja de entrada |
Una API puede encajar mejor en una aplicación que ya intercambia datos mediante HTTP y JSON. SMTP puede ser más práctico cuando el software incluye una biblioteca de correo o permite configurar un servidor SMTP sin desarrollar una integración nueva.
Ninguna opción garantiza por sí misma una mejor entregabilidad o un envío más rápido. La autenticación, la reputación del remitente, la calidad de los destinatarios, la infraestructura y los filtros del buzón siguen siendo relevantes.
Elige según la arquitectura de tu aplicación y las capacidades documentadas del proveedor. Revisa también cómo se reportan los errores y qué método de autenticación admite tu software.
¿Por qué usar una API de correo electrónico?
Una API resulta útil cuando el envío debe formar parte de un proceso de la aplicación, en lugar de depender de una tarea manual.
Automatización. Cuando un pedido queda confirmado, el backend puede solicitar el correo correspondiente. Define el disparador con precisión para que un carrito abandonado no genere una confirmación de compra.
Integración. Una aplicación SaaS, una tienda en línea o un sistema interno puede conectar sus propios eventos con el envío. Utiliza los datos del registro original en lugar de depender de que alguien copie información entre herramientas.
Personalización. La aplicación puede proporcionar el nombre del cliente, el número de pedido o los detalles de una cita. Valida esos valores antes de incorporarlos al mensaje.
Plantillas. Un diseño reutilizable permite separar la presentación de los datos que cambian. La estructura de una confirmación puede mantenerse igual mientras cada solicitud proporciona un número de pedido diferente.
Seguimiento. Las respuestas de la API informan sobre el resultado de la solicitud o sus errores. La visibilidad posterior de la entrega depende de las herramientas de estado disponibles en el proveedor.
Una integración mediante API también es distinta de la administración de una cuenta con IA. El código de tu aplicación define el evento y la solicitud; un cliente de IA puede interactuar con herramientas autorizadas mediante MCP. Nuestra guía sobre MCP para email marketing explica esa diferencia.
Cómo enviar un correo con la API de EmailMassivo
EmailMassivo documenta este endpoint REST para el envío transaccional:
POST https://api.emailmassivo.com/api/v1/external-mails/send/{key_id}
La integración utiliza dos elementos diferentes:
- Token de API: autoriza el acceso y tiene permisos configurables.
- ID de la clave de envío o sending key: identifica la entidad de envío asociada con un dominio verificado.
No son intercambiables. El token se envía en el encabezado de autenticación; el ID de la sending key forma parte de la URL.
Paso 1. Crea una clave de API
Crea una clave de API en tu cuenta de EmailMassivo y habilita el permiso external_mail.send.
Guarda el token de forma segura en el servidor. Para el ejemplo siguiente, debe estar disponible en una variable de entorno llamada EMAILMASSIVO_API_TOKEN.
No lo incluyas en JavaScript del navegador ni lo guardes en un repositorio de código.
Paso 2. Configura el dominio y la clave de envío
Utiliza un dominio verificado y crea una sending key asociada con él.
Una clave de envío recién creada no se activa de inmediato: la documentación de EmailMassivo indica que debes contactar a soporte para activarla. Completa este paso antes de hacer la prueba.
La dirección que incluyas en mail.from.email debe pertenecer al dominio de esa sending key.
Paso 3. Envía tu primer correo
Antes de ejecutar el ejemplo, reemplaza:
42por el ID de tu clave de envío activa.customer@example.compor un buzón existente que controles.receipts@example.orgpor una dirección de tu dominio de envío verificado.
Las direcciones del ejemplo son marcadores de posición, no destinos para una prueba real.
curl --request POST \
"https://api.emailmassivo.com/api/v1/external-mails/send/42" \
--header "Authorization: Bearer ${EMAILMASSIVO_API_TOKEN}" \
--header "Content-Type: application/json" \
--include \
--data-raw '{
"idempotencyKey": "order-8042-confirmation",
"mail": {
"to": {
"email": "customer@example.com",
"name": "Alex"
},
"from": {
"email": "receipts@example.org",
"name": "Tienda de ejemplo"
},
"subject": "Recibimos tu pedido 8042",
"html": "<p>Hola, Alex. Recibimos tu pedido 8042.</p>"
}
}'
Este ejemplo proporciona el contenido mediante mail.html. EmailMassivo también admite mail.text; debes incluir al menos uno de esos campos.
Usa una idempotencyKey que identifique el mensaje lógico que estás enviando. El valor del ejemplo corresponde a una confirmación específica, no a todos los correos de tu aplicación.
Paso 4. Revisa la respuesta
El estado exitoso documentado es:
200 OK
El cuerpo de la respuesta incluye un identificador del mensaje:
{
"uuid": "018e8042-abcd-7000-8000-000000000001"
}
Este UUID es ilustrativo. Guarda el valor que devuelva tu solicitud real.
Los errores utilizan códigos HTTP y detalles estructurados. Revisa esos detalles antes de repetir la solicitud. Cuando reintentes el mismo envío lógico, conserva la misma idempotencyKey.
La documentación de Email API de EmailMassivo contiene las definiciones de los campos y las respuestas. El ejemplo anterior reproduce la estructura documentada; no representa un envío de prueba ejecutado para este artículo.
Cómo enviar correos transaccionales con plantillas
Puedes preparar el contenido de dos formas.
Envío directo: tu aplicación proporciona el HTML o texto completo. Es una opción para sistemas que ya generan su propio contenido.
Envío con plantilla: tu aplicación identifica una plantilla guardada y proporciona los valores de sus variables.
EmailMassivo documenta este endpoint para el segundo método:
POST /api/v1/external-mails/send-by-template/{key_id}
Dentro de mail, utiliza:
idTemplateMailUserpara identificar la plantilla de tu cuenta.paramspara proporcionar los valores de sus variables.
Estos campos sustituyen a html o text en la solicitud de envío por plantilla.
En una confirmación de pedido, los parámetros podrían incluir customerName y orderNumber. Los nombres deben coincidir con las variables utilizadas en la plantilla; no cambies los identificadores únicamente porque el texto del correo esté en español.
La categoría pública de plantillas transaccionales muestra 19 diseños al 13 de octubre de 2026. Elige uno adecuado para la finalidad del mensaje.
Ver un diseño en el catálogo no significa que ya exista como plantilla utilizable mediante API dentro de tu cuenta. Para el envío necesitas el ID de la plantilla guardada correspondiente.
Si todavía estás eligiendo el diseño, consulta nuestra guía sobre plantillas de email marketing y cómo elegir la adecuada.
Seguridad y entregabilidad al usar una API de email
Protege las credenciales y controla los reintentos
Mantén los tokens en el servidor, utiliza HTTPS y concede únicamente los permisos necesarios para la integración.
No repitas indefinidamente una solicitud que falla. Revisa si el problema está en las credenciales, los campos enviados, la configuración del remitente o una condición temporal del servicio.
Proporciona una idempotencyKey para cada mensaje lógico. Conserva ese valor al reintentar el mismo envío después de un timeout y utiliza uno diferente para una notificación nueva.
EmailMassivo documenta este campo como mecanismo de protección contra envíos duplicados.
Configura y supervisa el remitente
Configura SPF, DKIM y DMARC según corresponda, utiliza direcciones de destinatarios válidas y supervisa errores y quejas.
Las directrices de Google para remitentes recomiendan los tres métodos de autenticación y distinguen los requisitos para remitentes generales y remitentes masivos.
Una API cambia la forma en que tu aplicación solicita el envío. No elimina la evaluación que hacen los servidores receptores.
La autenticación, la reputación, el comportamiento de envío y los filtros del destinatario siguen siendo independientes de una respuesta exitosa de la API. Ni la integración ni la configuración de autenticación garantizan que el correo llegue a la bandeja de entrada.
Preguntas frecuentes
Conecta eventos de software con solicitudes de envío. Una aplicación puede utilizarla para confirmaciones, verificación de cuentas, recuperación de contraseñas, recibos y notificaciones. La aplicación decide cuándo enviar y qué información necesita el destinatario.
Una API de email suele recibir solicitudes HTTP mediante endpoints específicos del proveedor. SMTP utiliza un protocolo de correo estandarizado. Ambos permiten automatizar envíos; la elección depende del software, la autenticación y el manejo de respuestas que necesites.
Sí, si el proveedor admite ese tipo de envío. Debes configurar el remitente, autenticar la solicitud y proporcionar los campos obligatorios. En EmailMassivo, verifica también que la sending key esté activada antes de hacer una prueba.
No cuando utilizas un proveedor de envío alojado. Aun así, necesitas código en el backend u otro componente del lado del servidor para enviar solicitudes de forma segura y administrar credenciales, contenido, errores y reintentos.
Sí, cuando el proveedor ofrece envío mediante plantillas. EmailMassivo documenta un endpoint que identifica una plantilla guardada en la cuenta y recibe los valores de sus variables. Un diseño público del catálogo no proporciona por sí solo ese ID.
No por sí sola. Automatiza la solicitud de envío, pero no garantiza la entrega ni la bandeja de entrada. Debes evaluar por separado la autenticación, la reputación, las direcciones, las quejas y los filtros de los servidores receptores.
Empieza con la API de EmailMassivo
Una API permite conectar los eventos de tu aplicación con mensajes transaccionales. EmailMassivo admite solicitudes con HTML o texto preparado, así como envíos que utilizan plantillas guardadas y valores de variables.
Empieza con un solo evento y un buzón que controles. Activa la clave de envío, envía la solicitud, revisa la respuesta y comprueba el mensaje recibido antes de ampliar la integración.