New webhook topic app/scopes_update

API

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 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:

{
  "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