Question : Comment connaître le statut de livraison d'un email transactionnel envoyé par API ?

Depuis septembre 2026, chaque email envoyé à l'unité par l'API (transactionnel) peut être suivi jusqu'à sa remise au serveur du destinataire.

1. L'envoi renvoie un identifiant

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

Avec l'API Email v2, POST /v2/send/sendmail.json renvoie de même l'identifiant de l'envoi.

2. Interrogez le statut

GET https://api.mailpro.com/v3/Send/123456/Status
Authorization: Bearer <votre 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 (ou .xml).

Les statuts

• queued — accepté, en attente d'envoi ; scheduled — planifié à une date ultérieure
• sent — transmis par nos serveurs, confirmation du destinataire pas encore reçue
• deferred — le serveur destinataire demande de réessayer plus tard (nous réessayons)
• delivered — accepté par le serveur du destinataire (diag_code = sa réponse)
• bounced — rejeté ; bounce_type précise s'il est définitif ou temporaire
• not_found — identifiant inconnu ou n'appartenant pas à votre compte

Le statut delivered apparaît environ 5 minutes après la remise. Il concerne les envois unitaires (API v2, API v3, relais SMTP, automation) — pas les campagnes, qui ont leurs statistiques. Les statuts sont conservés 365 jours.

Vous préférez être prévenu plutôt qu'interroger ? Abonnez-vous à l'événement email.delivered : webhook ou statut, lequel choisir ?. Référence complète sur le portail développeurs.