Endpoints /emails de la API v2 ya disponibles

¡Nos complace anunciar que los endpoints de email ya están disponibles en la API v2! Ahora puedes enviar emails, consultarlos, actualizar los programados y cancelar los pendientes, todo ello a través de nuestra potente API REST.

Nuevos endpoints

Enviar email

POST /v2/emails

Envía un email a uno o varios destinatarios. El endpoint de envío admite:

• Varios destinatarios — Envía a hasta 50 destinatarios (TO, CC y BCC combinados)
• Plantillas — Usa alias o ID de plantilla con sustitución de variables mediante la sintaxis {{variable}}
• Adjuntos — Incluye archivos mediante contenido en base64 o una URL
• Programación — Programa emails para enviarlos más adelante con ISO 8601, marcas de tiempo Unix o lenguaje natural en inglés, como «tomorrow at 9am»
• Seguimiento — Sobrescribe la configuración de seguimiento predeterminada del dominio para aperturas y clics
• Metadatos — Adjunta pares clave-valor personalizados que se almacenan y se devuelven con el email
• Idempotencia — Evita envíos duplicados con la cabecera Idempotency-Key

Al enviar a varias direcciones, cada destinatario recibe su propio ID de email único para un seguimiento individual.

Obtener email

GET /v2/emails/{id}

Consulta información detallada sobre un email concreto, incluidos:

• Estado actual (pendiente, programado, enviado, entregado, rebotado, cancelado)
• Cabeceras y contenido sin procesar del email
• Configuración de seguimiento
• Metadatos personalizados
• Marcas de tiempo de creación y actualización

Actualizar email programado

POST /v2/emails/{id}

Reprograma un email cuyo envío está previsto para más adelante. Puedes cambiar la hora programada siempre que falten al menos 3 minutos para el envío.

Cancelar email

POST /v2/emails/{id}/cancel

Cancela un email programado o pendiente antes de que se envíe. En el caso de los emails programados, la cancelación debe solicitarse al menos 3 minutos antes de la hora de envío programada.

Límites de peticiones

Cada respuesta incluye cabeceras de límite de peticiones para que puedas controlar tu uso:

• ratelimit-limit — Máximo de peticiones por segundo
• ratelimit-remaining — Peticiones restantes en el segundo actual
• ratelimit-daily-limit — Máximo de peticiones diarias
• ratelimit-daily-remaining — Peticiones diarias restantes

Documentación

Ya está disponible la documentación completa, con ejemplos de código en Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET y cURL:

• Enviar email
• Obtener email
• Actualizar email programado
• Cancelar email

Próximamente: API de plantillas

Estamos trabajando en la API de plantillas, que te permitirá crear, actualizar y gestionar plantillas de email de forma programática. ¡No te pierdas esta novedad!

Aviso de retirada de la API v1

Importante: la API v1 está obsoleta y dejará de funcionar a finales de febrero de 2026. Si todavía usas la API v1, migra a la API v2 lo antes posible.

¿Necesitas ayuda con la migración? Consulta nuestra documentación de la API v2 o ponte en contacto con nuestro equipo de soporte.