Email Logs

Access prerequisites

• Permission (module): access restricted to administrator (guard admin)
• License/Feature: None
• Menu container: GENERAL → group Audit

What it is / when to use

The Email Logs screen (/email-logs) lists all emails the platform attempted to send via NotificationService (delivery provider — e.g.: Mailgun/Brevo/SendGrid/SES). Each record shows recipient, sender, subject, status (SUCCESS/FAILURE), date and — in the detail view — the body and HTML of the email, plus the error message when there is a failure.

Use this screen to confirm whether a notification was delivered (e.g.: registration confirmation email, password recovery, transaction notice) and to diagnose delivery failures.

Prerequisites

• Permission: route protected by an administrator guard. Permission is dual — CPM enum on the backend + dynamic module in the DB.
• License/Feature: none.
• Dependencies on other screens: logs are recorded automatically by NotificationService on each delivery attempt.

Step by step

1. Access the menu GENERAL → Audit → Email Logs (embedded guide button available — book icon).
2. The listing loads the current page (20 items per page).
3. (Optional) Filter by recipient email and click Search.
4. Click View details to open the modal with the full email content.
5. Navigate between pages with Previous/Next.

Filters and columns

Filter / Column	What it shows	Data source
Email (filter)	Filters by recipient	email parameter sent to the backend
Status	SUCCESS (sent) or FAILURE (failed). Failures display an error indication	status / error_message
To	Recipient; also shows the template_id when present	to_email / template_id
From	Sender	from_email
Subject	Email subject	subject
Sent at	Date/time of the attempt	sent_at
Actions	Opens the detail view	—

Fields (detail modal)

Field	What it is	Source
Subject	Sent subject	subject
Body (text)	Plain-text content of the email	body
HTML	Rendered HTML content	html_content
Error message	Failure detail (when FAILURE)	error_message

Actions and modals

• Search: resets pagination and re-runs the query filtered by email.
• View details: opens the EmailLogDetailsModal with subject, body, HTML and error.
• Embedded guide (book icon): opens the contextual help (helpGuide.emailLog).

Business rules / caveats

Attention

• Pagination is estimated: since the backend returns only the current page, the total is inferred (if fewer items than the page size are returned, it is the last page). Do not rely on the "X of Y" counter as an exact email count.
• An email with body present but empty HTML (or vice-versa) usually indicates the classic bodyData × htmlData bug: some providers (Brevo/SendGrid/Mailgun) break when only one of the fields is populated, while SES masks the problem. If you see failures only on a specific provider, suspect this.

Related screens

• Bulk action — Email
• Audit (overview)