Email Logs
The Email Logs product provides a centralized view of recent email activity for your account. It allows you to search, filter, and inspect individual messages to understand their delivery path and troubleshoot issues. Email Logs will replace the legacy Email Activity experience as the primary tool for message-level troubleshooting and observability.
Email Logs includes filters to help you locate and view specific messages. Each filter supports exact string matching. Additional filter functionality will be developed and released in the future.
The following filters are available to efficiently locate and analyze log events. Each filter supports exact-string match with specific capabilities including partial matching, autocomplete, and multi-select options:
- Recipient Email Address: Search for a specific recipient email address.
- Account: Filter by username or subuser username.
- Subject: Filter messages by the email's subject line.
- Date: Filter messages within a specific send time range using a date picker.
- Category: Filter by your defined category names.
- Status: Filter by the message's delivery outcome (e.g., received, dropped, processed, delivered, deferred, bounced, or blocked).
- Response: Search by the receiving server's response code or response text.
- Message ID: Search for a specific sg_message_id. This is occassionally presented as message id or msg_id.
Selecting a message from the results list opens the Email Details page, which provides a complete view of that message's lifecycle and delivery timeline.
The page is divided into several sections:
At the top of the page, you'll see high-level message attributes, including:
- Message ID: The unique sg_message_id for the selected message.
- To/From: The recipient and sender email addresses
- Subject: The subject line of the email.
- Account Username: The username that sent the message.
- Sending IP Address: The IP address from which the message originated.
A visual timeline displays each stage in the message's lifecycle. This describes how Twilio SendGrid processed the email, whether it was delivered to the recipient domain, and what engagement occurred on the email. A summary banner below the timeline shows the end-to-end time, which represents how long it took the email to move from initial processing to final delivery.
Beneath the time, the Event History table lists each recorded event for that message. The events are ordered chronologically by event type. You can use the expand all events toggle to show every event in the timeline when multiple occurrences of the same event type exist.
Click view details next to an event to open a detailed panel showing the full JSON payload of that event. This payload matches the data delivered through the Event Webhook to ensure a consistent troubleshooting method across Twilio SendGrid's different data solutions.