Subscription Spend Alerts

​

Configuring via the Dashboard

1

Open the subscription

Go to Billing → Subscriptions, or open a customer and select their subscription, from either the Subscription Details page or the customer’s Overview tab subscriptions list.

2

Open Alert Settings

Click the three-dot menu (⋮) on the subscription and select Alert Settings.

3

Enable alerts

Turn Enable Alerts on.

4

Configure thresholds

Set Threshold Value for the levels you want (Critical, Warning, Info). Condition is fixed to Above. Use Remove to drop a level you don’t need, then click Save Changes.

​

Configuring via API

{
  "entity_type": "subscription",
  "entity_id": "subs_01K7YQ8ZR4M3V2N1XA9C6D0EFG",
  "config": {
    "alert_enabled": true,
    "info":     { "threshold": "250",  "condition": "above" },
    "warning":  { "threshold": "500",  "condition": "above" },
    "critical": { "threshold": "1000", "condition": "above" }
  }
}

curl -X POST 'https://api.cloud.flexprice.io/v1/alerts/setting' \
  -H 'x-api-key: <api_key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "entity_type": "subscription",
    "entity_id": "subs_01K7YQ8ZR4M3V2N1XA9C6D0EFG",
    "config": {
      "alert_enabled": true,
      "info":     { "threshold": "250",  "condition": "above" },
      "warning":  { "threshold": "500",  "condition": "above" },
      "critical": { "threshold": "1000", "condition": "above" }
    }
  }'

​

Alert Behavior

• Recalculates spend: On every usage event for the subscription, recomputes total usage-based spend using the same invoicing-grade calculation (commitment- and overage-aware) used to generate invoices
• Compares against thresholds: Evaluates the recalculated total against Critical, Warning, and Info
• Updates state: Reflects the current state (ok, info, warning, in_alarm) in alert history
• Notifies: Sends a webhook only when the state changes, not on every event

​

Managing Alert Settings

​

Viewing current configuration

​

Changing thresholds

​

Removing a threshold

​

Disabling alerts

​

Webhooks

​

Use Cases

• Overall budget cap: Alert when a customer’s total subscription spend approaches or exceeds a contracted limit
• Early warning for usage spikes: Set Info well below Critical to catch unexpected spend trends before they become a problem
• Account health monitoring: Route alerts to a support or account-management queue

​

Related

• What Are Spend Alerts?: all three alert scopes, shared validation, and the full API reference
• Line item spend alerts: monitor one line item instead of the whole subscription
• Group spend alerts: monitor spend across a feature group
• Webhooks: endpoint setup, payload signatures, and retry behavior