The SendGrid Event Webhook lets you stream all email events directly to Keen IO for real-time analysis and long term raw storage.

It only takes a couple of minutes to start streaming email event data from SendGrid to Keen IO and once you do you can start analyzing and visualizing your data in a whole bunch of different ways.

Send your SendGrid Data to Keen IO

Step 1: Create a Keen IO and SendGrid account

Step 2: Activate SendGrid’s Event Notification App

Log into your SendGrid account, click on Settings from the left menu → Select Mail Settings. Then click Event Notification.

SendGrid- Mail Settings

Step 3: Set the HTTP POST URL (example below) as the endpoint where SendGrid will stream all of your email data.

1
https://api.keen.io/3.0/projects/YOUR_KEEN_PROJECT_ID/email/sendgrid/1.0?api_key=YOUR_KEEN_API_WRITE_KEY

You can snag a prebuilt URL in Keen’s UI or make your own.

In the Keen IO settings, select the events you want to post to Keen IO. To do this, under Select Actions, check All.

That’s it! Now, as your emails make their way through SendGrid, all of the event information will be posted to Keen IO. A new Event Collection, for each type of email event, will be created within your Keen Project.

Test Your Integration

Test that everything is working by clicking on the “Test Your Integration” button in SendGrid’s “Event Notification” Settings. This will send sample email data from SendGrid into your Keen IO Project. In the Keen UI, click on “Check for SendGrid Data” button.

Your SendGrid email data should now be populated in Keen IO.

SendGrid Email Analytics

Once you have data successfully flowing from SendGrid to Keen, a new application called SendGrid Email Analytics will appear on your projects page’s “Apps” tab.

To find it, visit your Keen home screen, select the project you’ve connected, in and click on the “Apps” tab. Find SendGrid and select “Launch App”. If you’ve successfully sent SendGrid data to Keen for storage, you will see the dashboard below.

SendGrid- Email Analytics App Dashboard Home

Now you can start tracking the performance of your emails by creating segments! In each one you can see Delivered Rates, Unique Opens, Unique Clicks, Click Rates, Unsubscribe Rates, Bounces, and Number of Emails Marked as Spam.

For each of these metrics, you can download a CSV of the detailed event data. Just click on any cell, and you’ll see a menu with the option to download a CSV. Learn who did or did not open an email for example, and with this list of email addresses you can build a more targeted user campaign.

Additional Resources: