> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesbricks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# usage.threshold.exceeded.precommitment

<Tip>
  Make sure to read the [Webhooks Overview](/api-reference/webhooks/overview) for important
  information about signature verification.
</Tip>

## Purpose

The `usage.threshold.exceeded.precommitment` webhook is triggered when a customer has used a set percentage of their pre-committed units on a usage brick, e.g. 90% of the units they committed to.

Configure the percentages on the brick under **Usage alerts**. See [Usage Alerts](/catalog/usage-alerts) for setup.

## When it fires

* Only usage beyond the brick's included units counts toward the pre-commitment. The included units are used up first.
* It fires only when the brick has a pre-commitment. A brick with included units and no pre-commitment never sends it.
* The percentage is measured over the pre-commitment's own window: each month, each reset period, or the whole contract when the pre-commitment is paid all upfront.
* It fires once per threshold in each window. If one usage record crosses several thresholds, one event is sent for each threshold crossed.
* It also fires for usage pools. The units and money usage webhooks do not.

<Note>
  Only usage in the current billing period is checked. Backfilling usage for an earlier period does
  not send this webhook.
</Note>

## Payload format

Your configured endpoint will receive a [Usage Threshold](/api-reference/webhooks/usage/payload) payload with `alerting_target_type` set to `pre-committed`. Both values are percentages.


## Related topics

- [usage.threshold.exceeded.money](/api-reference/webhooks/usage/threshold-exceeded-money.md)
- [usage.threshold.exceeded.units](/api-reference/webhooks/usage/threshold-exceeded-units.md)
- [Usage Threshold Payload](/api-reference/webhooks/usage/payload.md)
