Nueva guía: cómo calentar una IP dedicada sin dañar tu reputación. Leer ahora →
MigoSMTP
API de correo

Envíe, rastree y gestione correo desde su código

Una API REST para envío, plantillas, eventos e informes, con claves de alcance limitado y errores claros.

Listo para agentes: un servidor MCP permite que los asistentes de IA envíen e inspeccionen correo con seguridad.

Solicitud
POST /v1/send
{ "from": "hello@example.com",
"to": "you@example.com",
"subject": "Hello" }
Respuesta
202 Accepted
{ "id": "msg_[id]" }
Idempotency-Key compatible
202 Accepted
JSON
Idempotente
Envíe con una sola llamada JSONAutentíquese con una clave bearer, envíe un cuerpo JSON breve y reciba de inmediato un ID de mensaje.
Inicio rápido
cURL
Node
Python
PHP
Python
import migosmtp
c = migosmtp.Client("KEY")
c.send(to="you@example.com",
template="welcome")
Enviado · 202
SDK tipados
Código abierto
Bibliotecas oficiales para su stackElija Node, Python, PHP o Go. Las mismas pocas líneas envían un mensaje y gestionan los errores igual en todas partes.
Alcances de la clave de API
Enviar correoPermitido
Leer eventosPermitido
Gestionar dominiosSolo administradores
Límite de tasa[n] sol./s
Mínimo privilegio
Rote con seguridad
Claves con exactamente el acceso que necesitanCree una clave por servicio, limite lo que puede hacer cada una y revoque una sin tocar las demás.
Límite de tasa
Pico de tráfico
La cola suaviza el pico
Nada se pierde
Contrapresión
Sin pérdida de datos
Absorba los picos con eleganciaCuando el tráfico supera su tasa, las solicitudes se ponen en cola y se vacían en lugar de fallar, así que nada se pierde.
eventos de mensajes
Eventos firmados
/events
200 OK
Almacén de datos
200 OK
Alertas
Reintento en 30 s
Firmado con HMAC
Al menos una vez
Los eventos vuelven del mismo modoLa misma superficie de API transmite a su endpoint los eventos de entregado, abierto, clic y rebotado, firmados.
Envíe la factura por correo a Priya y confirme la entrega
Agente de IA
MigoSMTP MCPclave con alcance limitado
send_emailEnviar un mensaje
get_eventsLeer resultados de entrega
check_domainVerificar registros DNS
Enviado · ID de solicitud registrado · entrega confirmada
MCP listo
Con alcance limitado y registrado
Deje que los agentes de IA llamen a su APILa misma API está disponible mediante MCP, de modo que un agente puede enviar correo, leer eventos y verificar DNS. Las claves tienen alcance limitado, las llamadas se registran y los envíos pueden requerir aprobación.
Una solicitud
SDK
Claves con alcance
Límites de tasa
Webhooks
API para agentes
Relay SMTPAPI RESTWebhooksIP dedicadasFirma DKIMInbound parsePlantillasAnalíticaListas de supresiónMonitorización de reputaciónValidación de correoRoles de equipo y registro de auditoríaRelay SMTPAPI RESTWebhooksIP dedicadasFirma DKIMInbound parsePlantillasAnalíticaListas de supresiónMonitorización de reputaciónValidación de correoRoles de equipo y registro de auditoría
Funcionalidades

Una API que se comporta bien en producción

Endpoints REST

Recursos predecibles para mensajes, plantillas, dominios y eventos.

Plantillas y variables

Envíe por nombre de plantilla y pase variables en cada mensaje.

Claves de idempotencia

Reintente con seguridad sin enviar duplicados.

Claves de API con alcance

Dé a cada servicio solo los permisos que necesita.

Webhooks

Reciba eventos firmados por cada resultado de entrega.

Errores y límites claros

Códigos de error coherentes y cabeceras de límite de tasa.

Cómo funciona

Su servicioLlama al endpoint de envío por HTTPS con una clave de API con alcance.
API de email de MigoSMTPValida la solicitud, aplica plantillas y límites, pone el mensaje en cola y devuelve un ID.
Eventos de vuelta a ustedLos webhooks firmados informan a su app de los resultados de entrega, rebotes y quejas.
PASO 1

Cree una clave de API

Elija los alcances y una lista de IP permitidas para el servicio que la usará.

PASO 2

Envíe su primer mensaje

Llame al endpoint de envío con un remitente verificado y un destinatario.

PASO 3

Escuche eventos

Registre un webhook para seguir entregas, rebotes e interacción.

Véalo en acción

Una plataforma, del primer envío a la bandeja de entrada

Cambie entre etapas para ver qué controla en cada paso. Interfaz ilustrativa. Todas las cifras y direcciones mostradas son datos de ejemplo.

app.migosmtp.com / sendDatos de ejemplo
En cola
184,320
Enviados hoy
6,418,905
Tasa
412/s
aceptadomensaje para you@example.com
aceptadomensaje para team@example.com
en colalote de 25 000 destinatarios
aceptadomensaje para ops@example.com
Para desarrolladores

Versionada, documentada y fácil de probar

Todo lo del panel está disponible por API, con ejemplos en los lenguajes que usted utiliza.

  • Claves con alcance y lista de IP permitidas
  • Solicitudes idempotentes para reintentos seguros
  • Formato de error coherente
  • SDK y ejemplos listos para copiar
De un vistazo
URL baseapi.migosmtp.com/v1
AutenticaciónClave de API Bearer
FormatoJSON sobre HTTPS
EventosWebhooks firmados
ReferenciaReferencia completa de la API y ejemplos de SDK
Resumen

¿Qué es una API de email?

Una API de email es una interfaz web que permite a su código enviar y gestionar correo llamando a endpoints HTTP en lugar de hablar SMTP. Con la API de email de MigoSMTP envía por POST una solicitud JSON con un remitente verificado, un destinatario y, o bien el contenido, o bien el nombre de una plantilla, y el mensaje se pone en cola para entregarse a través de nuestra infraestructura MigoMTA. La respuesta incluye un identificador para seguirlo. También puede enviar con HTTP sin procesar.

La API es ideal para equipos de producto que quieren recursos predecibles para mensajes, plantillas, dominios y eventos. Las claves tienen alcance limitado, así que un servicio de facturación puede enviar recibos sin poder editar dominios. Las claves de idempotencia hacen seguros los reintentos, y los códigos de error coherentes con cabeceras de límite de tasa permiten a los clientes reducir el ritmo sin problemas. Todo lo del panel también está disponible por API. El tráfico de pruebas y el de producción pueden separarse con distintos espacios de trabajo y claves, lo que mantiene los envíos de prueba fuera de sus informes y de su reputación reales.

Para la entregabilidad, una API le da un control que SMTP no ofrece: errores estructurados, metadatos por mensaje y webhooks de eventos que puede reincorporar a su aplicación. Combínela con la gestión de supresión y dejará de enviar a direcciones malas de forma automática. Nuestro servidor MCP permite que los agentes de IA llamen a la misma API con claves revocables y de alcance limitado, de modo que la automatización se mantiene dentro de los límites que usted fija. Como cada clave tiene alcance limitado y queda registrada, puede ver exactamente qué servicio o agente envió cada mensaje y revocar el acceso de inmediato si hace falta.

Casos de uso

Casos de uso habituales de la API de email

Email transaccional desde su app

Dispare recibos, restablecimientos de contraseña y alertas con una sola llamada a la API. Envíe por nombre de plantilla y pase variables, y el código de producto se mantiene libre de HTML y de cambios de texto.

Reintentos seguros en colas de trabajos

Adjunte una clave de idempotencia a cada envío. Si un worker falla y reintenta, la API de email reconoce el duplicado y no envía el mismo mensaje dos veces.

Claves por servicio en microservicios

Emita una clave con alcance limitado por servicio, con una lista de IP permitidas. Si un servicio se ve comprometido, revoca una sola clave y el resto de su flujo de email sigue funcionando.

Cerrar el ciclo con eventos

Combine el endpoint de envío con webhooks para que su base de datos refleje los estados entregado, rebotado y con queja. Así, soporte puede responder adónde fue un email sin abrir los logs.

Notificaciones desde un producto SaaS

Envíe eventos dentro de la app, como invitaciones, alertas de uso y avisos de facturación, a través de una sola API, con una clave por servicio y plantillas gestionadas por el equipo de producto.

Agentes y automatización

Dé a un agente de IA o a una herramienta interna una clave con alcance limitado que solo pueda enviar o solo pueda leer el estado. Cada llamada queda registrada con esa clave, así que puede revisar lo que hizo y revocarla en cualquier momento.

Elegir un método

¿API de email o relay SMTP?

Ambos entregan a través de la misma infraestructura. Elija según cómo esté construido su software.

API de correoRelay SMTP
Ideal paraCódigo nuevo que quiere plantillas, idempotencia y respuestas estructuradasApps existentes, plugins de CMS y dispositivos que ya hablan SMTP
IntegraciónHTTPS y JSON desde cualquier lenguajeHost y credenciales en la configuración de correo
ErroresCódigos de error estructurados y cabeceras de límite de tasaCódigos de respuesta SMTP
Control de accesoClaves de API con alcance, lista de IP permitidas opcionalCredenciales por cuenta y lista de IP permitidas

Puede usar ambos en un mismo espacio de trabajo: SMTP para las herramientas que no puede cambiar y la API para los servicios nuevos.

Funciones de IA

API de email con asistencia de IA

Listo para agentes

Servidor MCP para agentes de IA

Conecte un asistente de IA a MigoSMTP mediante un servidor MCP para que pueda consultar el estado de los mensajes o redactar envíos. Las claves llevan los alcances que usted concede, y los envíos pueden requerir aprobación humana.

Copiloto

Copiloto de diagnóstico de errores

Pegue un error de API o una solicitud fallida y el copiloto explica la causa, como un remitente sin verificar o un campo mal formado, y muestra una llamada corregida. La corrección la aplica usted.

Asistencia

Código de integración redactado con IA

Describa lo que quiere enviar y el asistente genera una solicitud de ejemplo en su lenguaje siguiendo las convenciones de nuestros SDK. Revísela y pruébela antes de llevarla a producción.

Predictivo

Detección de picos y abuso

La detección de anomalías vigila el ritmo de envío por clave y señala ráfagas inusuales. Puede avisar a su equipo o sugerir pausar una clave, y cualquier acción automática es algo que usted decide activar.

Las funciones de IA son de apoyo y opcionales: los agentes actúan solo dentro de los alcances que usted concede, y su equipo mantiene el control de las claves y los envíos.

Buenas prácticas

Buenas prácticas para la API de email

Use claves de idempotencia en cada envío

Genere una clave estable por cada email lógico, como el ID del pedido más el evento. Así, los reintentos tras un timeout nunca producen mensajes duplicados.

Limite las claves al mínimo

Dé a cada servicio solo los permisos que necesita y añada una lista de IP permitidas cuando las direcciones sean fijas. Un radio de impacto menor simplifica la respuesta a incidentes.

Respete las cabeceras de límite de tasa

Lea las cabeceras de límite en cada respuesta y reduzca el ritmo antes de que le limiten. El backoff exponencial con jitter absorbe las ráfagas sin saturar la API.

Verifique las firmas de los webhooks

Compruebe la firma de cada evento antes de confiar en él. Rote el secreto de forma periódica y de inmediato si pudo filtrarse.

Guarde el ID del mensaje

Guarde el identificador que devuelve la llamada de envío junto con su propio registro. Facilita después las consultas de soporte y la conciliación de eventos.

Mantenga separados pruebas y producción

Use espacios de trabajo y claves distintos para staging y producción. Así, los errores de prueba no llegan a destinatarios reales ni afectan a su reputación.

Preguntas frecuentes

API de email: preguntas frecuentes

¿Necesita ayuda con su integración? Nuestro equipo puede revisarla con usted antes de salir a producción.

¿Qué es una API de email?

Una API de email es un conjunto de endpoints HTTP que permite a su software enviar y gestionar correo sin administrar servidores de correo. Usted envía una solicitud JSON, el proveedor pone el mensaje en cola y lo entrega, y usted recibe actualizaciones de estado mediante respuestas y webhooks.

¿Cómo envío un email con la API de MigoSMTP?

Cree una clave de API, verifique un dominio remitente y luego envíe por POST un JSON al endpoint de envío con una dirección from, un destinatario y, o bien el contenido, o bien una plantilla con variables. La respuesta devuelve un ID de mensaje que puede seguir. Consulte la referencia de la API para ver los campos.

¿Cuál es la diferencia entre una API de email y SMTP?

SMTP es un protocolo que el software existente ya habla, por lo que no requiere cambios de código. Una API usa HTTPS y JSON, lo que ofrece errores estructurados, plantillas, idempotencia y metadatos. Ambos usan la misma infraestructura de entrega, así que elija según cómo esté construida su aplicación.

¿Hay un sandbox para probar la API de email?

Use un espacio de trabajo y una clave de API distintos para las pruebas, de modo que los envíos de prueba queden fuera de sus informes reales y de su reputación de remitente. No comparta nunca una clave entre envíos de prueba y reales. Consúltenos si necesita configurar un modo de prueba para su cuenta.

¿Cómo se aplican los límites de tasa de la API?

Los límites se devuelven en las cabeceras de respuesta, de modo que su cliente puede ver la capacidad restante y reducir el ritmo antes de ser limitado. Los valores que le corresponden dependen de su plan. Cree clientes que lean las cabeceras y reduzcan la velocidad de forma gradual.

¿Puedo enviar emails por lotes?

Consulte la referencia de la API para conocer las opciones de lote y los límites de destinatarios de su plan. Sea cual sea el tamaño del lote, envíe una clave de idempotencia con cada solicitud y respete las cabeceras de límite de tasa, para poder reintentar un fallo parcial sin duplicados.

¿Qué es el servidor MCP de MigoSMTP?

Un servidor MCP es una forma estándar de que los asistentes de IA llamen a herramientas. El nuestro permite que los agentes compatibles trabajen con la API de email, por ejemplo para consultar el estado de un mensaje, con claves de alcance limitado que usted controla. Los envíos pueden requerir la aprobación de una persona.

¿Qué lenguajes y SDK se admiten?

Es una API REST sobre HTTPS, así que sirve cualquier lenguaje capaz de hacer solicitudes HTTP. En la documentación encontrará ejemplos listos para copiar y SDK. Guarde las claves de API en variables de entorno o en un gestor de secretos, nunca en el código fuente.

Empieza a enviar en minutos.

Crea una cuenta, añade tu dominio y envía tu primer correo.