| Product
2 min read ellipse November 18, 2022

Webhook Failures Notifications with Convoy

Webhook endpoints fail for several reasons, some of which can be:

  1. Rate Limiting
  2. Dead endpoints.
  3. Firewall
  4. Timeout.
  5. Random network errors.
  6. Invalid/Expired SSL certificates
  7. Server Error.

It is the responsibility of a good webhook delivery system to send out a form of automated notification on these delivery problems. This has been sufficiently written about; you can see this article written by a former Stripe engineer about critical features for your webhooks delivery system.

While this provides great UX for the owner of the endpoint, it also helps to keep your endpoint delivery system efficient — It prevents you from wasting system resources trying to communicate to zombie endpoints. The best practice is to

  1. Disable the endpoint
  2. Send out a notification containing the failure reason to the endpoint owner.
  3. Allow the endpoint owner re-activate the endpoint.
  4. Replay events that weren’t sent, when the endpoint was down.

This is precisely what Convoy does. Let’s see how this looks like

Failure Notifications

In Convoy, we send out email notifications to failing endpoints. When enabled, the email looks something like this:

Network Errors

Email notifications on network errors.

Email notifications on network errors.

Server Errors

Email notifications on webhook endpoints with the stack trace.

Email notifications on webhook endpoints with the stack trace.

To achieve this with Convoy, do the following:

  1. Create your endpoint, and set a support email on each endpoint.
  2. Enable notifications on the endpoint.
  3. Provide a dashboard for users to re-activate their endpoints. To provide this, we built an endpoint portal you can easily share with your users.
  4. To replay missed events, users can filter for discarded events (events sent when the endpoint was dead) and batch retry all of them.


In this article, we expanded on why it’s important to publish endpoint notifications, the best practices on webhook failure notifications, how this works in Convoy, and how this works in Convoy.

If this sounds interesting, we hope you try it out and give us some feedback.

More Posts

post image

Introducing Convoy App Portal

One of the essential characteristics of a reliable webhooks infrastructure is visibility. We're enabling you to extend that visibility to your customers. Unlike the Convoy Dashboard, App Portal is for just one application; giving your customers a good and extensive..

post image

Introducing Convoy

After weeks of work, I'm pleased to announce our new tool — built to send webhooks efficiently. While building out our initial API on third-party monitoring, every user we spoke to wanted asynchronous events — "Do you provide webhooks to notify us about downtime?". We