If you are looking for the new Email Activity documentation, please go here.
The Email Activity feed allows you to view a snapshot of email-related activity associated with your account. These logs display all of your email events - filter by event type or search by email address.
Email activity shows the most recent 500 events. To access data in real time, implement our Event Webhook.
To filter by event type:
To search the Activity feed by email, mailbox name or domain name:
To see a subuser's email activity, log in as that subuser or impersonate the subuser account.
You cannot see a parent accounts email activity from a subuser account.
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. |
| 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 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. |
| Parse | Triggered if you're using the Inbound Parse Webhook. |
You can check email delivery status by using the Email Activity page, or by using the Event Webhook.
For a successful delivery, the Email Activity page, or the Event Webhook shows a delivered event - expanding it shows a reason code of 250 OK. This means the receiving server has accepted the message. You can also check bounced, deferred, and processed messages.
If you can't find an email on the Email Activity page, check your suppression lists; bounces, blocks, spam reports, invalid email.
Have the recipient check their spam folder.
In your logs, you may see the following error messages accompanying a deferral event:
Email was deferred due to the following reason(s): ["IPs reached ISP-suggested hourly limits" http://send.gd/1uKnEBh]
Email was deferred due to the following reason(s): ["IPs reached ISP-suggested max connection limits: http://send.gd/1uKnEBh"]
Email was deferred due to the following reason(s): ["IPs reached max port limit"]
Email was deferred due to the following reason(s): ["IP reached max connection limit"]
A drop occurs when you try to send a message to an email address listed on one of the suppression lists: Bounces, Unsubscribes, Spam reports and Invalid Emails. If an email is already on one of the lists, our systems automatically drop the email to protect your Sender Reputation.
A dropped message cannot be resent automatically. To resend a message, first remove the email from the suppression list, and then recreate and resend the email.
A bounce is a Drop event that occurs when a message to an address has previously Bounced.
You can visit the Bounces list under the Suppressions tab, and search the address to find the details of the original attempt, such as the date and full error reason code. Once an address is on this list, we do not attempt to deliver further messages to it; we drop the message to protect your external reputation.
A bounced message cannot be resent automatically. To resend a message, first remove the email from the suppression list, and then recreate and resend the email.
A delayed bounce occurs when a recipient server accepts a message (Delivered) and then is promptly declined (Bounced). This is an infrequent occurrence, and SendGrid treats these messages as a bounce, and any future sends to this address are dropped, unless you remove the email from your bounce suppression list.
SendGrid automatically drops emails sent to addresses on suppression lists. If you want to retry sending an email to an address that is on a suppressions list, you need to remove it from the list first.
Only remove emails from these lists if you're sure the recipients want to receive the email. Otherwise, continuously sending to recipients who don't want your emails can negatively impact your sender reputation.
To remove an email from a suppression list:
You can receive bounce notifications to a specific address by enabling the "Forward Bounces" feature in your account and defining the forwarding address. However, you can also set it to send any bounces back to the originating FROM address.
To receive a bounce notification report to the FROM address on the email that bounced:
If you are sending bounce messages to a Gmail account, you need to set up an email filter in your inbox to tell Gmail not to send these messages to your spam folder.
When Gmail doesn't see a corresponding message in the sent folder connecting the bounce message, it may decide that the bounce message isn't valid and send it to spam.
One way to do this is in the filter, set up From daemon and Has the words daemon, and check the box Never send it to Spam.
These are some common issues people see with reading their email activity feed.