Collecting data with Trackers and Webhooks

  1. Home
  2. Docs
  3. Collecting data with Trackers and Webhooks
  4. Webhooks – collecting data from third parties
  5. Sendgrid



This webhook integration lets you track a variety of events logged by SendGrid.

Available events are:

  • Processed
  • Dropped
  • Delivered
  • Deferred
  • Bounce
  • Open
  • Click
  • Spam Report
  • Unsubscribe
  • Group Unsubscribe
  • Group Resubscribe



Integrating SendGrid’s webhooks into Snowplow is a two-stage process:

  1. Configure SendGrid to send events to Snowplow
  2. (Optional) Create the SendGrid events tables for Amazon Redshift

Configure SendGrid

First login to SendGrid. Select Settings from the menu panel along the left-hand side of the screen. You should then navigate in the expanded list to the Mail Settings page.

Select Event Notification from the list by clicking the row. Ensure it’s switched ON in order to send events to Snowplow.

Click edit on the top right-hand side of the Event Notification dropdown.

For the HTTP POST URL field you will need to provide the URI to your Snowplow Collector. We use a special path to tell Snowplow that these events are generated by SendGrid:

http://<collector host>/com.sendgrid/v3
Code language: HTML, XML (xml)

Our Webhooks setup page should look like this after we have added our HTTP POST URL:

If you want, you can also manually override the event’s platform parameter by appending a query string to the end of the URL so:

http://<collector host>/com.sendgrid/v3?p=<platform code>
Code language: HTML, XML (xml)

Supported platform codes can again be found in the Snowplow Tracker Protocol; if not set, then the value for platform will default to srv for a server-side application.

The other values you can set up manually in the similar fashion are nuidaidcveidttm, and url.

Before we save our SendGrid webhook we can configure what types of events SendGrid will send to our webhook and what channels will trigger these events. Simply select the boxes that are applicable to you and SendGrid will send these events to our webhook.

If you’d like to learn more about Snowplow BDP you can book a demo with our team, or if you’d prefer, you can try Snowplow technology for yourself quickly and easily.