Journaux et exports
Retrouvez n'importe quel e-mail ou requête d'API, voyez ce qui s'est passé et téléchargez vos données en CSV.
Trois outils vous aident à répondre à « que s’est-il passé ? » : la liste des e-mails, le journal des requêtes d’API et l’export CSV.
E-mails
Dans le tableau de bord, E-mails liste tous les e-mails envoyés par votre équipe. Recherchez par destinataire, objet ou identifiant d’e-mail, et filtrez par statut, clé API, marque (domaine d’envoi), source (transactionnel ou campagne) et période.
Ouvrez un e-mail pour voir :
- ses événements dans l’ordre : envoyé, remis, retardé, rebond, ouvert, cliqué, etc., avec la raison d’un retard ou d’un rebond,
- le contenu tel qu’il a été envoyé (aperçu, HTML ou texte brut) et ses en-têtes,
- pour un e-mail qui n’est pas encore parti, pourquoi il attend (limite du forfait, préchauffage, contrôle de sécurité, etc.),
- sa note des Insights de délivrabilité.
Via l’API, GET /emails liste les e-mails (les plus récents d’abord, avec pagination par curseur) et GET /emails/{id} renvoie un e-mail avec son dernier événement. Les deux exigent une clé API à accès complet. Pour recevoir les événements en temps réel, utilisez les webhooks.
Les corps des e-mails et leur historique sont conservés 30 jours avec tous les forfaits, puis supprimés.
Journal des requêtes d’API
Journaux dans le tableau de bord liste toutes les requêtes faites avec vos clés API ou via MCP, sur les 30 derniers jours. Chaque ligne affiche le statut, la méthode, le chemin, la clé ou l’application connectée qui l’a émise, et l’heure.
- Recherchez par chemin, clé ou identifiant de requête. Filtrez par source (clé API ou MCP), par clé API, par classe de statut (
2xx,4xx,5xx) et par période. - Ouvrez une ligne pour voir le corps de la requête et celui de la réponse. Ils vous aident à comprendre pourquoi un appel a renvoyé
422ou403. - Les corps ne sont stockés que s’ils sont en JSON et font moins de 64 Ko. Le contenu des e-mails (
html,text) est remplacé par sa taille, les secrets comme les jetons et les mots de passe s’affichent comme[redacted], et les en-têtes ne sont jamais stockés. - Seuls les propriétaires, les administrateurs et les développeurs voient les corps.
Export CSV
Les pages qui listent vos données ont un bouton Exporter en CSV. Le fichier reprend les filtres que vous avez appliqués : il correspond donc à ce qui est affiché. Un export contient au plus 50 000 lignes, les plus récentes d’abord. Il utilise votre connexion au tableau de bord, il n’existe donc pas d’endpoint d’API pour cela.
Ce que vous pouvez exporter dépend de votre rôle dans l’équipe :
| Export | Où | Rôles |
|---|---|---|
| Contacts, désinscriptions, destinataires d’une campagne | Pages Contacts, et page d’une campagne | Propriétaire, administrateur, marketing |
| Domaines, clés API, journal des requêtes d’API | Leurs propres pages | Propriétaire, administrateur, développeur |
| E-mails, liste de suppression, journal d’audit | E-mails, Contacts → Suppressions, Paramètres | Propriétaire, administrateur |
L’export du journal des requêtes contient les colonnes request_id, created_at, method, path, status, duration_ms et caller. L’export des contacts inclut une colonne unsubscribed et une colonne unsubscribed_domains (* désigne toute l’équipe).
Effacer les données d’une personne
Pour retirer un destinataire de votre historique, supprimez le contact avec erase: true, comme décrit dans Contacts. Cela retire aussi l’adresse de l’historique des e-mails, des charges utiles d’événements et des journaux de requêtes d’API.