Saltar al contenido

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

Un envío real con idempotencia (de la documentación de la API)
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

El envío es asíncrono: la API valida la petición, guarda el email y responde 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 critical para códigos de acceso y restablecimientos, con una cola de mayor prioridad.

Idempotencia y pruebas

Con la cabecera 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 .

Antes de aceptar cada email, la API comprueba la lista de bajas : si la dirección está bloqueada, el email queda como suppressed , no se envía y no consume cuota. Para enviar con claves live necesitas un dominio verificado .

Límites

La API admite 10 peticiones por segundo por organización. El HTML admite hasta 512 KB y el texto hasta 256 KB. Las claves 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.

Pedir acceso a la beta