Alerts and Webhooks
An alert is a notification that fires when a monitor produces a result matching a trigger condition. Alerts connect APIContext to your incident-response toolchain so your team learns about problems without watching a dashboard.
Trigger conditions
Each alert listens for one or more result categories:
| Trigger | When it fires |
|---|---|
| Pass | The monitor met all conditions (useful for negative testing — alert when a call that should fail unexpectedly succeeds) |
| Slow | The response completed but exceeded a latency threshold |
| Warning | The response triggered a warning condition (by default, 4xx HTTP status) |
| Error | The response triggered an error condition (by default, 5xx HTTP status) |
| SLA | The call or workflow step exceeded its Service Level Objective for duration or another SLA metric |
You can also set a failure threshold — for example, only fire after two consecutive failures — to reduce noise from transient issues.
Delivery channels
APIContext delivers alerts to a wide range of platforms:
- Email — simple but not recommended for high-volume scenarios
- Webhooks — Slack, Microsoft Teams, PagerDuty, OpsGenie, VictorOps, BigPanda, Datadog, New Relic, StatusPage, and others
- OpenTelemetry — the recommended default; sends structured telemetry to any OTLP-compatible backend (Axiom, Hydrolix, Honeycomb, etc.)
Each integration type has its own configuration fields (e.g., PagerDuty requires an integration key and severity level).
Scope: per-monitor vs. global
Alerts can be configured on a single monitor or globally for every monitor in a project. Global alerts save setup time when you want the same notification rules across all endpoints.
Organization-wide alert suppression is also available from Organization settings, which disables all alerts until re-enabled.
See also
- Setting up alerts and webhooks — step-by-step configuration guide
- Conditions and assertions — the rules that determine pass, warning, and error outcomes
- Alerting capabilities — platform overview of escalation paths and team routing