Line Item Spend Alerts

​

Configuring via the Dashboard

1

Open the subscription for editing

Go to Billing → Subscriptions, open the subscription, and go to Edit Subscription.

2

Open the line item's menu

Find the line item to monitor, click its three-dot menu (⋮), and select Alert Settings. It appears alongside Edit and Terminate for that line item.

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_line_item",
  "entity_id": "subs_line_01K7YQ0000LINEITEM00001",
  "parent_entity_type": "subscription",
  "parent_entity_id": "subs_01K7YQ8ZR4M3V2N1XA9C6D0EFG",
  "config": {
    "alert_enabled": true,
    "warning":  { "threshold": "150", "condition": "above" },
    "critical": { "threshold": "300", "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_line_item",
    "entity_id": "subs_line_01K7YQ0000LINEITEM00001",
    "parent_entity_type": "subscription",
    "parent_entity_id": "subs_01K7YQ8ZR4M3V2N1XA9C6D0EFG",
    "config": {
      "alert_enabled": true,
      "warning":  { "threshold": "150", "condition": "above" },
      "critical": { "threshold": "300", "condition": "above" }
    }
  }'

​

Alert Behavior

​

Managing Alert Settings

​

Viewing current configuration

​

Changing thresholds

​

Removing a threshold

​

Disabling alerts

​

Webhooks

​

Use Cases

• Per-charge budgets: Alert on a specific metered charge (e.g. a particular API or compute meter) without noise from the rest of the subscription
• High-cost line items: Set tighter thresholds on line items with the highest per-unit cost or the most usage variance
• Customer-specific overrides: Combine with per-subscription price overrides to alert on a customer’s negotiated rate independently

​

Related

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