Email Activity Feed

Higher volume users may not yet have access to the new Email Activity Feed. For information about the legacy Email Activity Feed, see Legacy Email Activity.

The Email Activity feed allows you to view a snapshot of recent email-related activity events associated with your account and any subusers. The email activity feed provides visibility into the email delivery flow of each email message to expedite the troubleshooting process. The email activity additional history add-on extends the history of email events accessible to 30-days.

With the Email Activity feed you can:

  • Troubleshoot email delivery issues faster with comprehensive and sequential event data by email message.
  • Pinpoint specific emails easily with advanced search and filter options --including subject line and email metadata.
  • Customize your data independently with CSV download/export option.
  • Increase storage available for up to 30 days for historical visibility within the UI by purchasing an upgrade.
  • Call all events by an email message from the API with additional storage purchase.

Reseller accounts and extra high volume accounts do not have access to the new Email Activity Feed. For information about the legacy Email Activity Feed, see Legacy Email Activity

In order to gain access to the Email Activity Feed API, you must purchase additional email activity history.

Types of email activity data

The Email Activity feed allows you to view specific information about messages sent from your account.

Event Description
Processed Requests from your website, application, or mail client via SMTP Relay or the API that SendGrid processed.
Clicks Whenever a recipient clicks one of the Click Tracked links in your email. In the Email History SendGrid displays the date, time, and the URL for the link that was clicked.
Delivered The accepted response generated by the recipients' mail server.
Opens The response generated by a recipient opening an email.
Unsubscribes Whenever a recipient unsubscribes from your emails.
Group Unsubscribes Whenever a recipient unsubscribes from a suppression group.
Group Resubscribes When a recipient resubscribes themselves to a suppression group.
Deferred The recipient mail server asked SendGrid to stop sending emails so fast.
Drops SendGrid will drop an email when the contact on that email is in one of your suppression groups, the recipient email previously bounced, or that recipient has marked your email as spam.
Bounces The receiving server could not or would not accept the message. If a recipient has previously unsubscribed from your emails, your attempt to send to them is bounced.
Blocks When your IP address has been blacklisted or blocked by an ISP or messaging organization. Blocks are less severe than bounces and do not result in permanent suppressions: subsequent sends to blocked email addresses are not automatically suppressed.
Spam Reports Whenever a recipient marks your email as spam and their mail server tells us about it.

Filtering email activity

The Email Activity feed lists each email sent. Click on each email to view the current list of triggered events for that email. Use our basic or advanced search to filter by email subject, recipients, or event types.

The email address field filters with an approximate, or fuzzy search. The date field pulls filters events that fit within the precise date range specified.

To filter by event type, like in the legacy Email Activity Feed, use Advanced search, and select Event Type, and choose an event type to filter by.

In addition to viewing the email activity associated with your account by recipient email address, domain, or event date, you can also use the following filters to sort your data:

  • API Key ID
  • API Key Name
  • Campaign ID
  • Campaign Name
  • Categories
  • Date Processed
  • Event Type (Bounced, Clicked, etc.)
  • 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 use advanced search:

  1. At the top of the Activity Feed page, click Advanced search.

  2. In the field on the far left, select the criteria to filter your event data.

  3. Once you have filled in all of the fields associated with that filter, click Search. To add additional search criteria, click Add a Filter.

To further narrow your search results:

  • Search emails by any of the following - This search will return more results and will pull in all events that meet one or more of the criterion specified by the selected filters. or
  • Search emails by all of the following - This search will return fewer results and will pull in events that meet every criteria specified by the selected filters.

Viewing event history

To view event history:

  1. Navigate to the event you wish to view and click on the entry. Once the entry loads, you can click into each of the sections to view more details of each email message.
  2. When you have finished reviewing the data, click close.

Exporting a CSV

To export a CSV:

  1. In the top right corner of the activity feed, click Export CSV. This triggers an email to the email address associated with your SendGrid account.
  2. Open the email and then click Download.

Additional Resources

See a mistake? Edit this page