Check a webhook's health
Learn what Healthy, Degraded and Unhealthy mean for a webhook, what the numbers on its row show, and what to do when deliveries fail.
This article explains how to tell whether a webhook is working.
What do the health labels mean?
Each webhook shows a health label:
- Healthy: messages are being delivered.
- Degraded: the last 3 messages in a row couldn't be delivered.
- Unhealthy: the last 5 messages in a row couldn't be delivered.
A single successful delivery sets it back to Healthy.
What do the numbers on the row mean?
- Events: the events this webhook sends.
- Delivered: how many messages your system has accepted.
- Failed: how many delivery attempts failed. Empath tries each message up to 4 times, so one message that never gets through can add up to 4 here.
- Last delivery: when Empath last finished trying to deliver a message, successfully or not.
When a webhook becomes Unhealthy
Your managers and admins get a Webhook endpoint unhealthy email and bell notification, as long as the Webhook & account alerts row is on. See “Account & system alerts”.
- Check that the address is correct and your system is online.
- Use Test Webhook to confirm it's working again.
Good to know
- Empath keeps trying to deliver to an Unhealthy webhook. It isn't switched off automatically.
- Messages that failed all their attempts aren't resent later.
Still need help?
Reach out to your Partner Success Manager, or email us at support@empathmsp.com. We’re happy to help!
Related articles
- Test, edit or delete a webhook
- Account & system alerts
- Webhook details for your developer