Alerts and escalation
When an API monitor changes state, VendorGate can notify your team by email or webhook. You can configure different actions for down, degraded, and recovery states.
Alert channels
Send a message to one or more addresses. This is the simplest way to notify a team.
Webhook
Send a signed POST request to a URL you control. The request includes details about the monitor, the checked endpoint, the failure reason, and the current state. Configure a signing secret and optional custom headers. Webhook payloads are signed with HMAC-SHA256 in the X-Vendorgate-Signature header by default; you can override the header name if needed.
Alert states
- Down: the endpoint has failed enough consecutive checks to be considered unavailable.
- Degraded: the endpoint responded, but one or more expected-response checks failed or the response time exceeded the threshold.
- Recovery: the endpoint is healthy again after being down or degraded.
Recovery alerts
You can enable recovery alerts so the team knows when an issue is resolved. This is useful for on-call rotations and incident tracking.
Escalation by consecutive failures
The monitor is marked down only after the configured number of consecutive failures. For example, with a one-minute schedule and a threshold of two, a brief 30-second outage will not trigger a down alert.
Best practice
Send down and degraded alerts to a channel the operations team monitors, and send recovery alerts to the same channel so the full lifecycle is visible.