Skip to main content
Log inSign up

Shopify uses cookies to provide necessary site functionality and improve your experience. By using our website, you agree to our privacy policy and our cookie policy.

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

Was this section helpful?