Webhooks not getting registered

Webhooks and Events
,
1

I am using the new Dev Platform for apps. The webhook subscriptions are defined in shopify.app.toml file. App is not registering webhook subscriptions on app install. When calling the following graphql API to check for webhook subscriptions, it returns empty array in response.

query {
  webhookSubscriptions(first:10) {
    nodes {
      id
    }
  }
}

Here is my toml file configuration.

# Learn more about configuring your app at https://shopify.dev/docs/apps/tools/cli/configuration

client_id = "xxxxx"
name = "xxxxx"
application_url = "https://example.com"
embedded = true

[build]
automatically_update_urls_on_dev = true
include_config_on_deploy = true

[webhooks]
api_version = "2025-10"

[[webhooks.subscriptions]]
topics = [ "app/uninstalled" ]
uri = "/webhooks/app/uninstalled"

[access_scopes]
# Learn more at https://shopify.dev/docs/apps/tools/cli/configuration#access_scopes
scopes = "write_products"

[auth]
redirect_urls = [ "https://example.com/api/auth" ]
2

To the best of my knowledge, only gql registered webhooks will be returned from that query. Any webhook subscriptions created in the toml are fully managed by Shopify.

1 Like
3

Makes sense. Even though getting empty array in response, I can see webhooks are getting trigerred. App specific webhooks are much easier to use. Having an option of shop specific webhooks added confusion.

Thanks for the explanation!

1 Like