Documentación de Vemudo
Envía emails por API, gestiona contactos y campañas, consulta tu cuenta y conecta asistentes de IA. Todo con claves de API y datos en la UE.
Tu primer email
Con una clave de API, un email son unas líneas. La guía de primeros pasos te lleva de la cuenta al primer envío.
curl -X POST https://api.vemudo.com/v1/emails \
-H "Authorization: Bearer $VEMUDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Tienda Alba <[email protected]>",
"to": "[email protected]",
"subject": "Tu pedido",
"html": "<p>Gracias por tu compra.</p>"
}'Por dónde empezar
Todas las guías
Empezar
- Primeros pasosCrea tu cuenta, conecta tu dominio, genera una clave de API y envía tu primer email con Vemudo en unos minutos.
- Autenticación y clavesCómo autenticarte con claves de API de Vemudo, qué significan los entornos test y live, los permisos send, read y full, y los límites de peticiones.
Enviar
- Enviar emailsEnvía emails transaccionales con la API de Vemudo: envío simple, lotes de hasta 100, adjuntos, programados, idempotencia, cancelación y pruebas con claves test.
- PlantillasCrea plantillas con variables en el panel de Vemudo, publícalas por versiones y úsalas desde la API con templateId y variables.
- Eventos y webhooksRecibe en tu servidor cada entrega, rebote o queja de Vemudo con webhooks firmados con HMAC, reintentos durante 72 horas y deduplicación.
- Bajas y supresionesCómo gestiona Vemudo la lista de bajas y bloqueos de tu organización: rebotes, quejas, bajas y altas manuales, y cómo consultarla o modificarla por API.
Audiencia y campañas
- Contactos, listas y segmentosGestiona tus contactos con consentimiento, organízalos en listas y etiquetas, define segmentos sencillos y consúltalos por API con una clave de solo lectura.
- Importación CSVImporta contactos desde un CSV a Vemudo con ensayo previo, mapeo de columnas, declaración de permiso e informe final. Límites de tamaño y reglas.
- Campañas e informeDiseña, programa y envía campañas de email con Vemudo, mide aperturas y clics en el informe y consulta sus métricas por API con una clave de solo lectura.
Cuenta
- Dominios y DNSVerifica tu dominio en Vemudo con 6 registros DNS (DKIM, MAIL FROM y DMARC), entiende los estados de verificación y qué pasa si un registro desaparece.
- Consultar la cuenta y estadísticasSaca por API de solo lectura todo lo de tu cuenta de Vemudo: resumen y uso del plan, listado de emails con filtros, eventos, estadísticas por día, dominios, contactos y campañas.
- Planes y cuotasPlanes de Vemudo (Inicio, Beta, Crece y Pro), emails y contactos incluidos, qué pasa al llegar a la cuota, excedente a 0,50 € por cada 1.000 emails y servicios de configuración.
- Errores y límitesFormato de los errores de la API de Vemudo (problem+json), códigos habituales por estado HTTP, límites de peticiones y tamaños, y cómo reintentar bien.
Asistentes de IA
- MCP y asistentes de IAConecta claude.ai, Claude Desktop, Claude Code, Codex, Cursor, VS Code u otro cliente MCP a tu cuenta de Vemudo con OAuth (sin claves) o con una clave de API.
- Changelog de la APIHistorial de cambios de la API de Vemudo y de /mcp para agentes de IA, con la fecha de disponibilidad en api.vemudo.com y la política de cambios.
Referencia de la API
- Referencia de la APIReferencia de la API de Vemudo generada del contrato OpenAPI: autenticación, convenciones y cada operación con su ruta, scope, parámetros, respuestas y ejemplo curl.
- Clave y organizaciónComprueba la clave que usas y la organización a la que pertenece.
- CuentaResumen de la cuenta: plan, uso del periodo, límites y recuentos.
- EmailsEnviar, cancelar y consultar emails y sus eventos.
- EstadísticasCifras de envío por día y tasas de entrega, rebote, queja, apertura y clic.
- DominiosDominios de envío, su verificación y sus registros DNS.
- ContactosConsulta de contactos de la organización.
- ListasListas de contactos con su número de miembros.
- SegmentosSegmentos guardados y su definición.
- CampañasCampañas y sus métricas.
- PlantillasPlantillas publicadas y su contenido.
- Bajas y bloqueosDirecciones a las que no se envía.
- WebhooksEndpoints que reciben los eventos de tus emails.