This article describes how to use the SendGrid data source to create a webhook in your SendGrid account and send actionable events to Tealium.
- SendGrid account
- EventStream/AudienceStream account
How it works
SendGrid offers a webhook API that sends outgoing requests to an endpoint that you specify. These requests act like push notifications to EventStream to inform it about things that happened in your SendGrid account. When you add the SendGrid data source in the UDH, a unique endpoint will be generated that you will use to configure Event notifications in your SendGrid account.
SendGrid data source
The SendGrid data source generates a unique URL to use as the HTTP POST URL in your SendGrid configuration. The generated URL is in the format of:
To add the SendGrid data source to your Tealium Customer Data Hub profile, see Data Sources. After adding and connecting the data source, save and publish your profile.
Once you have your data source endpoint you can proceed to your SendGrid account to create the webhook.
- In SendGrid, go to Settings > Mail Settings.
- Turn on Event Notification.
- In the HTTP POST URL field, paste you data source endpoint.
- Select the Event notifications you would like to subscribe to.
- Click the checkmark in the top corner to save these updates into your settings.
Events and attributes
All incoming SendGrid events are automatically converted to event attributes prefixed and underscored with
sendgrid_. For example, when the SendGrid webhook sends
smpt-id, the matching event attribute is
See the full list of webhook events and attributes generated by SendGrid:
||String||“processed”, “dropped”, “delivered”, “deferred”, “bounce”, “click”, “spamreport”, “unsubscribe”, “group_resubscribe”, or “group_unsubscribe”|
||String||“500 unknown recipient”|
||String||“400 try again later”|
||String||“Mozilla/4.0 (compatible; MSIE 6.1; Windows XP; .NET CLR 1.1.4322; .NET CLR 2.0.50727)”|
Thank you for your feedback!
This page was last updated: January 7, 2023