← Back to Docs

Alerts

Overview

The Alerts page lets you configure notification rules for stock issues and view the history of triggered alerts. Alerts can be delivered via email, Slack, or in-app.

Alert Rules

Configurable Conditions

ConditionTriggerNotification Channel
Low StockProduct stock falls below low thresholdEmail, Slack, In-app
Critical StockProduct stock falls below critical thresholdEmail, Slack, In-app
StockoutProduct reaches zero stockEmail, Slack, In-app
Dead StockNo sales for configurable days (default: 90)Email, Slack

Alert History

Triggered Alerts

Shows a chronological log of all triggered alerts with the product, type, timestamp, and whether it has been acknowledged.

ColumnDescription
DateWhen the alert was triggered
TypeLow stock, critical, stockout, or dead stock
ProductProduct name and SKU
MessageAlert description with details
StatusPending or acknowledged

Notification Settings

SettingDescription
email_enabledSend alerts to email address
slack_enabledSend alerts to Slack webhook
digest_frequencyImmediate, daily, or weekly digest
weekly_digestSend weekly summary email

API Endpoints

EndpointDescription
GET /api/alerts/rulesList all alert rules
POST /api/alerts/rulesCreate a new alert rule
PUT /api/alerts/rules/{id}Update an existing rule
DELETE /api/alerts/rules/{id}Delete an alert rule
GET /api/alerts/historyView alert history
POST /api/alerts/history/{id}/acknowledgeMark alert as acknowledged
POST /api/alerts/checkManually trigger alert evaluation
Automation: Alerts are automatically checked during product sync. The Alert Engine evaluates all conditions and sends notifications based on your settings.