Usage Threshold Payload - Salesbricks

All three usage threshold webhooks send the same payload. alerting_target_type tells you which kind of threshold was crossed, and it decides the unit of the two values.

Field	Description
`webhook_run_id`	Salesbricks ID of this webhook run.
`subscription_id`	Salesbricks ID of the Subscription whose usage crossed the threshold.
`brick`	The usage brick: its `id`, `name`, and `code`.
`transaction_id`	The `transaction_id` of the usage record that pushed usage over the threshold, as you sent it to the Usage API.
`alerting_target_type`	`pre-committed`, `units`, or `money`.
`alert_threshold_value`	The threshold you configured on the brick, as a decimal string.
`actual_usage_value`	Usage at the moment the threshold was crossed, as a decimal string. It is always greater than or equal to `alert_threshold_value`.

The unit of alert_threshold_value and actual_usage_value depends on alerting_target_type:

`alerting_target_type`	Unit	Example
`pre-committed`	Percent of the pre-commitment used	`"90.00"` is 90%
`units`	Units of the brick	`"1000.00"` is 1,000 units
`money`	The smallest unit of the order’s currency, e.g. cents for USD	`"10000.00"` is $100.00

Example

JSON

{
  "event_type": "usage.threshold.exceeded.units",
  "webhook_run_id": "00000000-0000-0000-0000-000000000000",
  "subscription_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "brick": {
    "id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
    "name": "API Calls",
    "code": "api-calls"
  },
  "transaction_id": "txn_20260930_0042",
  "alerting_target_type": "units",
  "alert_threshold_value": "1000.00",
  "actual_usage_value": "1012.00"
}