Search

Manage your transactional logs and email previews

The transactional logs in Brevo keep track of everything that happens to your transactional emails, such as when they were sent, delivered, opened, or clicked. These actions are called "events", and they are recorded for all emails sent via API, SMTP, and automation workflows. You can also preview the content of sent emails and export your log data for reporting or troubleshooting purposes.

Good to know

Transactional logs and email previews are stored indefinitely by default. You can configure a custom retention period at any time. To learn more, check our dedicated article Manage the retention period of transactional logs and email previews.

❗ Important
If your account has sent more than 10 million email events, an additional platform-wide policy applies: any events older than 24 months will be automatically deleted, regardless of your custom settings. Affected accounts receive advance notifications (in-app and by email) before any deletion occurs. If you need to retain data beyond 24 months, an extended retention option is available with the Enterprise plan. To learn more, check our dedicated article About the data retention policy.

Access your transactional logs

To access your transactional logs, go to Transactional > Logs. The logs page lists all the actions that happened on your transactional emails, such as when an email was sent, opened, or when a contact clicked an unsubscribe link.

From the Logs page, you can:

mceclip0.png
  1. Refresh the page to view the most recent transactional logs.
  2. Export your transactional logs as a CSV file.
  3. Filter your transactional logs by recipient, recipient domain, message ID, subject line, or keyword.
  4. Filter your transactional logs over a period of time.
  5. Filter your transactional logs by event, by sender, and by tag.
💡 Good to know
To filter your logs for emails sent through automations, use a dedicated sender or add a tag to the emails used in your automations. You can then use these as filters in your logs.

Export your transactional logs

💡 Good to know
The export includes the main log details only. If you need additional data, such as the sending IP address, reply-to address, or template ID, you can retrieve it using the Brevo Transactional Email API.

You can export up to 200,000 log entries as a CSV file for use in external reporting tools, audits, or troubleshooting. The exported file includes the following details:

  • st_text: type of event
  • ts: timestamp
  • sub: email subject
  • frm: sender
  • email: recipient
  • tag: any tags
  • mid: message ID
  • link: any clicked links

To export your transactional logs:

  1. Go to Transactional > Logs.
  2. (Optional) Apply filters to narrow down the entries you want to export.
  3. Click Download CSV.
    transactional-logs_download_en-us.png

The CSV file is generated and downloaded to your device.

❗ Important
The export only includes log entries within your current retention period. Events deleted under the data retention policy cannot be recovered or exported retroactively.

View a transactional log details and email preview

You can access the full details of a transactional log and preview the content of the sent email.

To access the full details of a transactional log:

  1. Go to Transactional > Logs.
  2. (Optional) Apply filters to narrow down the logs and find the email you want to preview.
  3. Click the eye icon next to the log entry. 
    transactional-logs_preview_en-us copy.png

From there, you can:

transactional-logs_preview-details_en-us copy.png
  1. View the transactional email details.
  2. View the transactional email history.
  3. Preview the rendered email content.
  4. See which links were clicked in the email.
  5. Resend the transactional email.
  6. Manually delete the transactional log.
❗ Important
Deletions are queued and processed in scheduled batches. Logs may take up to 72 hours to be fully deleted.

⏭️ What's next?

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.

💬 Was this article helpful?

8 out of 41 found this helpful