Announcing a New Version of our Event Notification Webhook

Posted on

API, checkWe recently released a new version of our Event Notification webhook. The Event Notification webhook allows customers to retain all the details of their email history. SendGrid will post data to customers’ applications anytime events occur to their emails. When mail is processed, delivered, dropped, opened, clicked, bounced, etc., we package that information up and provide it to customers.

This new version posts a JSON array containing the event data to a url of the customer’s choosing. We also added in the ability for customers to test this webhook prior to enabling it, so you can make sure everything is configured properly. In addition to updating the configuration page we have also made significant back-end improvements to improve the speed and stability of this webhook.


Customers who have never enabled the event notification webhook before will be using this new version by default. Existing customers who have previously utilized the event webhook will remain on their current version. Please note that new sub accounts will also default to the new version, but can be switched back to v2 via the API. Please check the documentation for all the details on this version and on how to upgrade.

Full documentation of this new version is available here:

Brian is SendGrid's Product Manager. He has over a decade of experience in SW Development, Productions/Ops, and Product Management.

Brian O'Neill on Twitter

4 thoughts on “Announcing a New Version of our Event Notification Webhook

  1. I like that you all put some test data in there, but it would also be nice if we could edit that form field. I already found myself doing that to test different cases etc, but would have much much preferred to post it from your testing dialog. Thanks.

  2. Maybe I'm missing something, but it looks like the difference between this and the old V2 batch events is that the old message was a list of valid json rows but not a valid document in itself. The new version simply wraps the rows in an array (i.e. it starts with "[" and ends with "]").

    Is there an easy way to tell which version of the api has posted to our event server, for example a version in the url? That way our service could handle both formats.

  3. Pingback: Event Webhook Update: Batched vs. Unbatched Events

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>