---
title: New webhook topic app/scopes_update - 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-webhook-topic-app-scopes_update
  md: https://shopify.dev/changelog/new-webhook-topic-app-scopes_update.md
---

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

October 1, 2024

Tags:

* Webhook
* 2024-10

# New webhook topic `app/scopes_update`

As of Webhook API version `2024-10` and `unstable`, apps can subscribe to the `app/scopes_update` webhook topic.

This webhook is triggered when the granted access scopes for the installed app on a shop have been modified. It allows apps to keep track of the granted access scopes of their installations.

For example, an app that has enabled [Shopify managed install](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation) is released with a new configuration that increased the requested scopes from `"read_customers"` to `"read_customers,read_discounts"`. Once a merchant opens the app and approves the `read_discounts` access scope this webhook will be emitted with payload:

```json
{
  "id": 1234,
  "previous": [
    "read_customers"
  ],
  "current": [
    "read_customers",
    "read_discounts"
  ],
  "updated_at": "2024-10-01T00:00:00.000Z"
}
```

Learn more about this webhook on [Shopify.dev](https://shopify.dev/docs/api/webhooks/unstable?reference=toml#list-of-topics-app/scopes_update)