Automation logs are detailed records that capture every step, action, and event in your automations. They are categorized into two types of logs, each providing distinct information. By examining these logs, you can identify issues, optimize processes, and ensure your marketing and transactional efforts function as intended.
Access your automation logs
To access your automation logs:
- Go to Automations > Logs. From there, you will find two types of logs.
- Go to the corresponding tab to view each type of logs:
-
Workflow logs
See what happened at each step of a specific automation. -
Contacts in Workflow
See which contacts are currently in an automation, and remove them if needed.
-
Workflow logs
Workflow logs
The Workflow logs page provides detailed records of every event that occurs within an automation, whether for a specific step or a particular contact. They help you identify a contact's position in the process, detect potential blockages, and understand why certain communications may not have been delivered.
What information can I find in a workflow log?
Each log gives you a quick summary at a glance, then lets you dig into the technical details behind it if you need to troubleshoot further.
When looking at a specific log in your workflow logs, you'll first find the following information:
- The date and time when the event happened.
- The email address of the contact who performed the action or moved through the automation.
- The name of the automation in which the event happened.
- The specific step in which the event happened.
- The message that describes the event.
To see the technical details behind a log, click the down arrow icon next to a log to expand it and see the following fields:
Field |
Description |
|---|---|
| scenario_id | The ID of the automation where the event happened. |
| type | The type of event recorded in the log (e.g., form, identify, templates_clicked, etc.). |
| start_id | The ID of the entry point of the automation where the event happened. It is displayed only if an automation has multiple entry points. |
| ts | The date and time when the event was recorded in the log. |
| step_id | The ID of the step the contact was in when the event happened. |
| message | The message that describes the event (e.g., "Contact has exited workflow", "Opened the campaign", etc.). |
| scenario_name | The name of the automation where the event happened. |
| workflow_points | The entry or exit step of the automation where the event happened. It is displayed only if the event happened when the contact started, restarted, exited, or was manually removed from the automation. |
| user_email | The email address of the contact who performed the action or moved through the automation. |
| new editor | Whether the event happened in an automation created with the new automation editor. |
How long are workflow logs retained in Brevo?
Brevo applies two independent rules to workflow logs:
Time-based limit
All workflow logs older than 24 months are deleted automatically, regardless of how many logs your account has.
Volume-based limit
Within that 24-month window, your plan sets a maximum number of logs that can be stored:
|
|
If your account exceeds this number within the 24-month window, only the most recent logs up to that limit are kept. Older logs beyond the limit are removed, even if they're less than 24 months old.
Contacts in workflow
The Contacts in workflows page displays which contacts are active, meaning they are currently progressing through an automation, and those on hold, who are at a waiting point within an automation. This helps you understand why certain communications have not been received.
Additionally, if you do not want a contact to continue through an automation or if there was an error, you can manually remove them from the automation, causing them to immediately exit.
What information can I find on the Contacts in workflows page?
- The email address of the contact currently in the automation.
- The name of the automation the contact is currently in.
- The specific step the contact is currently in.
- The date and time when the contact entered the automation they're currently in.
Remove a contact from an automation
You can manually remove contacts from your automation from the Contacts in workflows page, whether they are currently in an active or waiting state.
To remove contacts from an automation:
- Go to Automations > Logs > Contacts in workflows.
- Select the contacts you want to remove from an automation. You can select up to 30 contacts at a time.
- Click Remove selected contacts from automations.
- Click OK.
That's it, the contacts have been removed from the automation they were previously in. A "Contact has been manually removed from workflow" log will also be generated in your workflow logs for each contact removed:
📥 Download your automation logs
You can download your workflow logs and your contacts in workflows logs separately, each as its own CSV file. The steps are the same on both pages:
- (Optional) Filter your logs.
- Click Download csv.
A CSV file will be downloaded to your device.
⏭️ 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.