The Event logs page gives you a detailed view of all events related to your contacts, whether they occurred in Brevo or were sent to Brevo from your website or app. Use it to verify that events are being received correctly, investigate unexpected activity, or export data for auditing purposes.
View and understand an event log
Use the search and filter options to locate a specific event log and view its full details. This is useful to check whether an event was correctly received by Brevo, or to troubleshoot why an automation did not trigger as expected.
Step 1: Access your event logs
- Go to Automations > Logs > Event logs.
-
Select the tab that corresponds to the type of events you want to review. Expand the following accordions to learn more about each type of event:
Custom EventsThe Custom Events tab displays custom events sent to Brevo via the Brevo tracker or Brevo API.
TrackingThe Tracking tab displays website tracking events recorded by the Brevo tracker installed on your website. This includes the identify event (used to link a visitor to a known contact), tracked link clicks, product and category views, and other page-level interactions.
CommerceThe Commerce tab displays all eCommerce, Product, Loyalty, Coupon, and Payment events sent to Brevo. This tab also includes the 3 default purchase events recorded by the Brevo tracker if you installed it using one of our plugins (
cart_updated,cart_deleted, andorder_completed).MarketingThe Marketing tab displays all marketing events, including email marketing, web push, wallet, and form events.
🔈 Coming soonMore event types related to Contacts, Conversations, Deals, Companies, SMS campaigns, WhatsApp campaigns, Transactional emails, and SMS campaigns.
- Use the available filters to narrow down the event logs. You can filter by event name, date range (up to 60 days), or a contact's full email address. Additionally, some event logs can be filtered by page URL, link click URL, and campaign ID.
- Review the list of event logs that match your filters. Each log displays the event name, date, email address, and IP address.
- Click the expand icon ▶️ next to an event log to view its full details.
Step 2: Understand event log details
Each event log includes information about the event that was recorded. Depending on the event you are viewing, these details may include:
- event_date: The date and time when the event occurred
- event_id: The unique identifier for the event
- event_source: The source of the event
- event_type: The type or category of the event
- contact_id: The unique identifier of the contact who triggered the event
- email_id: The unique identifier of the email associated with the event
- campaign_id: The identifier of the campaign associated with the event
- campaign_name: The name of the campaign associated with the event
- ip_address: The IP address from which the event was triggered
Some event logs also include metadata (the complete event payload). To view or copy this data, click Copy JSON.
Export your event logs
You can export your event logs as a CSV file to analyze data outside of Brevo, share it with your team, or keep records for auditing purposes.
-
(Optional) Use the available filters to narrow down the event logs.
💡 Good to knowThere is no date range restriction when exporting. You can export up to 10,000,000 events per export. If you need to export more than 10,000,000 events, split your export into multiple date ranges. - Click Export as CSV. The file will be available in the notification center 🔔 in a few minutes.
FAQs
If you can’t find an event in your logs, check the following:
- Verify the date range and make sure you’re viewing the correct time period.
- Check that the event was actually sent by reviewing your integration, API request, or workflow logs.
In some cases, an event log may not be generated in Brevo:
- If a visitor declines cookies on your website, Brevo cannot track their actions. As a result, the event will not be recorded in your logs.
- If the request failed before entering the Brevo system (for example, due to an invalid API key, a missing required field, or failed validation), no log entry may be created.
A Delivered status means Brevo successfully handed the email to the recipient's mail server, but it does not guarantee the email reached the inbox. The most common causes are:
- The email was filtered into spam/junk.
- The recipient's mail server accepted it but silently discarded it.
- The email arrived in a secondary inbox (Promotions tab, etc.).
Ask the recipient to check all folders, and verify your sender domain authentication (SPF, DKIM, DMARC) is correctly set up.
By default, Brevo stores event logs with no time limit. However, once you reach 10 million events in your Brevo account, all email events older than 24 months are deleted after a 7-day buffer period. This only applies to email events, such as when an email is sent, delivered, opened, or clicked by a contact.
To learn more, check our dedicated article FAQs - About the data retention policy for email events.
⏭️ What's next?
- What are automation logs? (workflow logs and contacts in workflow)
- FAQs - About the data retention policy for email events
🤔 Vous avez des questions ?
Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.
Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.