Primeros pasos
Crea tu cuenta, conecta tu dominio, genera una clave de API y envía tu primer email con Vemudo en unos minutos.
Por Equipo Vemudo · Actualizado el
curl. Todo lo que ves aquí funciona igual desde cualquier lenguaje, porque la API es HTTP y JSON.
1. Crea tu cuenta
test (ver más abajo); las claves live exigen que la organización esté activa.
2. Conecta tu dominio
[email protected] tienes que demostrar que el dominio es tuyo.
En el panel, abre Dominios y añade el dominio. Vemudo te muestra 6 registros DNS: 3 de DKIM, 2 del dominio de rebotes ( bounce.tu-dominio.com) y 1 de DMARC. Cópialos en el panel de tu proveedor de DNS, o envía las instrucciones a quien lo gestione.Vemudo comprueba los registros solo, con esperas crecientes durante 72 horas, y te avisa cuando el dominio queda verificado.
3. Crea una clave de API
Entorno: testpara probar sin enviar correo real,livepara enviar de verdad.Permisos (scope): sendpara enviar,readpara consultar,fullpara todo.
vm_test_ o vm_live_ y se muestra una sola vez. Guárdalo en una variable de entorno o en un gestor de secretos; no lo pongas en código ni en el navegador. Más detalles en Autenticación y claves.
export VEMUDO_API_KEY="vm_test_..."4. Comprueba la clave
curl https://api.vemudo.com/v1/me \
-H "Authorization: Bearer $VEMUDO_API_KEY"5. Envía tu primer email
curl -X POST https://api.vemudo.com/v1/emails \
-H "Authorization: Bearer $VEMUDO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: primer-envio-1" \
-d '{
"from": "Tienda <[email protected]>",
"to": "[email protected]",
"subject": "Tu pedido está en camino",
"html": "<p>Gracias por tu compra.</p>"
}'202 con el identificador del email, porque el envío es asíncrono:
{ "id": "..." }GET /v1/emails/{id}. Verás cómo pasa de accepted a queued, submitted y delivered.
Claves test y live
test | live | |
|---|---|---|
test obtienes los mismos estados, eventos y webhooks que con una live, así que puedes probar tu integración completa antes de enviar nada. Para provocar rebotes y reintentos en pruebas usa el dominio de simulación que se explica en Enviar emails.
Siguientes pasos
Enviar emails: lotes, adjuntos, envíos programados e idempotencia. Plantillas: contenido reutilizable con variables. Eventos y webhooks: entérate de cada entrega, rebote o queja. MCP y asistentes de IA: conecta Claude, Cursor o VS Code a tu cuenta.