API de email transaccional desde la UE
Un POST con el remitente, el destinatario y el contenido. Vemudo lo acepta al momento, lo envía con Amazon SES en la UE y te cuenta cada paso.
Revisado el
curl -X POST https://api.vemudo.com/v1/emails \
-H "Authorization: Bearer $VEMUDO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-1042" \
-d '{
"from": "Tienda Alba <[email protected]>",
"to": "[email protected]",
"subject": "Tu pedido",
"text": "Gracias por tu compra."
}'Qué hace
202 con su identificador. El envío, los reintentos y la entrega ocurren después, y los consultas con GET /v1/emails/{id} o por webhooks . Hay un destinatario por email; para enviar a varios, el endpoint de lotes admite de 1 a 100 emails por petición con validación de todo o nada.
Contenido en HTML, texto o plantilla publicada con variables. Hasta 10 adjuntos y 10 MB en total; los tipos peligrosos (ejecutables, scripts) se rechazan. Envíos programados hasta 72 horas en el futuro y cancelables mientras no hayan empezado. Etiquetas de hasta 10 pares clave y valor que viajan con el email y con los eventos. Categoría criticalpara códigos de acceso y restablecimientos, con una cola de mayor prioridad.
Idempotencia y pruebas
Idempotency-Key un reintento tras un corte de red no duplica el email: misma clave y mismo cuerpo en 24 horas devuelven la respuesta original. Con una clave test el email no sale, pero tu integración ve todo el ciclo: entrega, rebote o queja según la dirección del dominio reservado simulator.vemudo.test .
suppressed , no se envía y no consume cuota. Para enviar con claves live necesitas un dominio verificado .
Límites
test tienen un tope de 100 envíos diarios. No uses la clave desde un navegador: la API no admite CORS y la clave quedaría visible, así que llama siempre desde tu servidor.
Preguntas frecuentes
¿Puedo enviar el mismo email a varias personas con una sola llamada?
Cada email tiene un único destinatario. Para varios, usa el endpoint de lotes, que admite hasta 100 emails por petición. Los lotes no admiten adjuntos ni envíos programados.
¿Qué pasa si mi servidor reintenta una petición?
Si envías la cabecera Idempotency-Key, Vemudo devuelve la respuesta original durante 24 horas en lugar de enviar el email otra vez.
¿Puedo probar la integración sin enviar correos reales?
Sí. Con una clave de entorno test el email no sale, pero pasa por los mismos estados y eventos, y no consume cuota del plan.
Prueba Vemudo en la beta
Pide acceso, conecta tu dominio y envía. Revisamos cada cuenta antes de activarla.