Email Activity Feed
Info
Higher-volume customers might not have access to the new Email Activity Feed yet. For information about the legacy feed, see Legacy Email Activity.
The Email Activity Feed displays a snapshot of recent email-activity events for your account and any subusers. Each entry shows the full delivery flow of the message, which helps you identify delivery issues. If you purchase the Email Activity history add-on, the feed retains events for up to 30 days.
Info
All Email Activity data is stored in the United States.
With the Email Activity Feed, you can:
- Examine sequential event data for each message to diagnose delivery issues.
- Locate specific messages with search and filter options, including subject line and message metadata.
- Download event data as a CSV file.
- View up to 30 days of events with the Email Activity history add-on.
- Retrieve all events for a message by using the Email Activity API when additional storage is enabled.
Info
Reseller accounts and extra-high-volume accounts don't have access to the new Email Activity Feed. For information about the legacy feed, see Legacy Email Activity.
The Email Activity Feed records the following events.
| Event | Description |
|---|---|
| Processed | An email request that SendGrid has received from your website, application, or mail client through SMTP Relay or the API. |
| Clicks | A recipient clicked a click-tracked link. The feed shows the time of the click and the destination URL. |
| Delivered | The recipient's mail server accepted the message. |
| Opens | The message was opened by the recipient. |
| Unsubscribes | The recipient unsubscribed from your email. |
| Group Unsubscribes | The recipient unsubscribed from a suppression group. |
| Group Resubscribes | The recipient resubscribed to a suppression group. |
| Deferred | The recipient's mail server asked SendGrid to slow down message delivery. |
| Drops | SendGrid didn't attempt delivery because the recipient is suppressed, previously bounced, or reported the message as spam. |
| Bounces | The receiving server rejected the message. Attempts to send to previously unsubscribed recipients are also bounced. |
| Blocks | The message was blocked by an ISP or messaging organization. Blocks are temporary and don't automatically suppress future sends. |
| Spam Reports | The recipient marked the message as spam, and the recipient's mail server reported the action to SendGrid. |
Warning
Deferral and bounce events might not include an IP address. For example, an internal deferral occurs when SendGrid detects an issue at a recipient's MX record and pauses delivery until the issue clears. Because no action is taken, no IP address is logged. A delayed bounce occurs when mail is accepted but later rejected after the SMTP conversation ends, so the subsequent bounce lacks the original connection information.
Danger
Parse events aren't available in the Email Activity Feed. Use your Inbound Parse endpoint to verify that parse events are posting correctly.
The Email Activity Feed lists each message. Select a message to view the events that have occurred for that message. Use the basic or advanced search to filter by subject line, recipient, or event type.
The email address field uses fuzzy matching. The date field limits events to the selected range.
Info
To filter by event type, select Advanced search, choose Event Type, and then select the desired event.
Advanced search supports the following filters:
- API Key ID
- API Key Name
- Campaign ID
- Campaign Name
- Categories
- Date Processed
- Event Type (Bounced, Clicked, and so on)
- From Email Address
- Message ID
- Number of Clicks
- Number of Opens
- Requesting IP Address
- Sending IP Address
- Status (Delivered, Not Delivered, Processing)
- Subject Line
- Teammate
- To Email Address
- Transactional Template ID
- Transactional Template Name
- Unsubscribe Group ID
- Unsubscribe Group Name
To run an advanced search:
-
At the top of the Activity Feed page, select Advanced search.
-
In the left-most field, choose a filter criterion.
-
Complete the remaining filter fields, and then select Search.
To add another filter, select Add a filter.
To adjust the breadth of the results:
- Search emails by any of the following returns events that match one or more selected criteria.
- Search emails by all of the following returns events that match every selected criterion.
To inspect a message's event history:
-
In the feed, select the desired message.
The right-hand information panel opens. Select any section to expand the details.
-
When you finish, select Close.
To export events to a CSV file:
-
In the upper-right corner of the Activity Feed, select Export CSV.
SendGrid sends a download link to the email address associated with your account.
-
Open the email and select Download.
Info
If you need deeper analytics, see SendGrid Email Insights Reports. A deliverability consultant can help interpret your performance data.