---
title: New WebHooks and App Events for App Usage Spending Limits and Changes to balanced_used - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/new-webhooks-and-app-events-for-app-usage-spending-limits-and-changes-to-balanced_used
  md: https://shopify.dev/changelog/new-webhooks-and-app-events-for-app-usage-spending-limits-and-changes-to-balanced_used.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

July 1, 2022

Tags:

* Action Required
* API
* 2021-10

# New WebHooks and App Events for App Usage Spending Limits and Changes to `balanced_used`

On July 31st 2022 we will be introducing App Usage Spending Limits to provide flexibility for merchants to control the usage charge limit per billing cycle from their Shopify admin. Developers no longer need to set a "one size fits all" app usage capped amount that is difficult to meet a variety of merchants' needs.

## Merchants Can Self-Serve Increasing Their Subscription's `cappedAmount`

As of July 31st 2022 Merchants will be able to increase the [`cappedAmount`](https://shopify.dev/api/admin-graphql/2021-10/input-objects/AppUsagePricingInput#field-appusagepricinginput-cappedamount) associated with a subscription that has usage pricing. Partners are advised to listen to the [`app_subscription/update`](https://shopify.dev/api/admin-graphql/2022-07/enums/WebhookSubscriptionTopic#value-appsubscriptionsupdate) webhook to stay notified when Merchants update their capped amounts. For instructions on how Merchants will be able to update their `cappedAmount` visit the [help center](https://help.shopify.com/en/manual/your-account/manage-billing/your-invoice/apps#app-usage-charges)

## App Usage Webhook Notifications

As of GraphQL Admin API version 2022-07, app developers offering usage-based pricing should subscribe to new webhook updates in advance of the roll out of App Usage Spending Limits. Developers can receive notifications when merchants update their App Spending Limits, which is also the `capped_amount` by [creating a webhook subscription through the Admin Graphql API](https://shopify.dev/apps/webhooks/configuration) to the [app\_subscriptions/update topic](https://shopify.dev/api/admin-graphql/2022-07/enums/WebhookSubscriptionTopic#value-appsubscriptionsupdate).

Once merchants update their App Spending Limits, developers may need to make updates to their application to allow merchants to incur additional usage charges.

Learn more about Admin Graphql API webhooks [here](https://shopify.dev/apps/webhooks/configuration).

## Important update about `balance_used` endpoint for app usage charges

The `balance_used` endpoint in the App Usage Pricing API now shows the running total usage charges for the entire billing cycle. Previously, there was an issue where the usage charge running total, presented on the `balance_used` field, resets when a new recurring charge with usage-based pricing is accepted by the merchant. Note that the issue only applied to the value being presented in the `balance_used` field and usage charges were not able to exceed the `capped_amount` in a cycle.

Going forward, the `balance_used` endpoint will always show the total usage charge balance for the billing cycle, which is reflective of what merchants see in the Shopify Admin about their current App Spending Limits.