---
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'
metadata:
  effectiveApiVersion: 2024-10
  affectedApi:
    - displayName: Webhook
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2024-08-27T12:51:31-04:00'
  postedAt: '2024-10-01T00:00:00-04:00'
  updatedAt: '2024-11-04T11:56:48-05:00'
  effectiveAt: '2024-10-01T00:00:00-04:00'
---

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)