Pregunta : ¿Cómo conocer el estado de entrega de un email transaccional enviado por API?

Desde septiembre de 2026, cada email enviado de forma unitaria por la API (transaccional) puede seguirse hasta su entrega al servidor del destinatario.

1. El envío devuelve un identificador

POST https://api.mailpro.com/v3/Send/Mail
Authorization: Bearer <su token>
→ 200  { "message": "Email queued", "id_single_send": 123456 }

Con la API Email v2, POST /v2/send/sendmail.json devuelve igualmente el identificador del envío.

2. Consulte el estado

GET https://api.mailpro.com/v3/Send/123456/Status
Authorization: Bearer <su token>
→ 200
{
"id_single_send": 123456,
"email": "[email protected]",
"status": "delivered",
"date_planned": "2026-09-16T08:00:00",
"status_date": "2026-09-16T08:03:41",
"diag_code": "250 2.0.0 OK",
"bounce_type": null
}

En v2: GET /v2/send/123456/status.json (o .xml).

Los estados

• queued — aceptado, en espera de envío; scheduled — programado para una fecha posterior
• sent — transmitido por nuestros servidores, sin confirmación del destinatario todavía
• deferred — el servidor del destinatario pide reintentar más tarde (reintentamos)
• delivered — aceptado por el servidor del destinatario (diag_code = su respuesta)
• bounced — rechazado; bounce_type indica si es definitivo o temporal
• not_found — identificador desconocido o que no pertenece a su cuenta

El estado delivered aparece unos 5 minutos después de la entrega. Se aplica a los envíos unitarios (API v2, API v3, relé SMTP, automatización), no a las campañas, que tienen sus estadísticas. Los estados se conservan 365 días.

¿Prefiere que le avisen en lugar de consultar? Suscríbase al evento email.delivered: webhook o estado, ¿cuál elegir?. Referencia completa en el portal para desarrolladores.