Endpoints /emails de API v2 Ya Disponibles

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

Nuevos Endpoints

Enviar Email

POST /v2/emails

Envía un email individual a uno o múltiples destinatarios. El endpoint de envío soporta:

• Múltiples destinatarios — Envía hasta 50 destinatarios (TO, CC, BCC combinados)
• Plantillas — Usa alias o IDs de plantillas con sustitución de variables usando sintaxis {{variable}}
• Archivos adjuntos — Incluye archivos mediante contenido base64 o URL
• Programación — Programa emails para entrega futura usando ISO 8601, timestamps Unix, o lenguaje natural como “mañana a las 9am”
• Seguimiento — Sobrescribe la configuración predeterminada del dominio para aperturas y clics
• Metadatos — Adjunta pares clave-valor personalizados que se almacenan y devuelven con el email
• Idempotencia — Previene envíos duplicados con el header Idempotency-Key

Cada destinatario recibe su propio ID de email único para seguimiento individual al enviar a múltiples direcciones.

Obtener Email

GET /v2/emails/{id}

Consulta información detallada sobre un email específico, incluyendo:

• Estado actual (pendiente, programado, enviado, entregado, rebotado, cancelado)
• Headers y contenido del email sin procesar
• Configuración de seguimiento
• Metadatos personalizados
• Timestamps de creación y actualizaciones

Actualizar Email Programado

POST /v2/emails/{id}

Reprograma un email configurado para entrega futura. Puedes cambiar la hora programada siempre que el email esté al menos a 3 minutos de ser enviado.

Cancelar Email

POST /v2/emails/{id}/cancel

Cancela un email programado o pendiente antes de que sea enviado. Para emails programados, la cancelación debe solicitarse al menos 3 minutos antes de la hora programada de envío.

Límites de Velocidad

Cada respuesta incluye headers de límite de velocidad para que puedas monitorear tu uso:

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

Documentación

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

• 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 programáticamente. ¡Mantente atento a esta emocionante incorporación!

Aviso de Deprecación de API v1

Importante: API v1 ha sido deprecada y dejará de funcionar a finales de febrero de 2026. Si aún estás usando API v1, por favor migra a API v2 lo antes posible.

¿Necesitas ayuda migrando? Consulta nuestra documentación de API v2 o contacta a nuestro equipo de soporte.