Webhooks are an easy way to get push notifications. A webhook is like an API endpoint but inverted; instead of making a call to our API, you define a callback URL to which we will HTTP POST information as things happen. Your callback URL can then execute code based on the POSTs. You can think of it as defining an API endpoint for your app that will receive output from SendGrid.

We currently have two Webhooks available. The Event Webhook will POST when an email event occurs, such as a bounce or an unsubscribe. The Inbound Parse Webhook will receive emails and then post their constituent components (e.g. subject, body, and attachments) to your URL.

Debugging

Webhooks can be hard to debug, for this reason we provide a guide to debug webhooks.

Caveats

Keep in mind that your servers need to be robust enough to handle a large number of requests from SendGrid’s webhooks, especially if you send or receive a lot of email. We offer a free load testing service, loader.io, that you can use to test your servers.