Shopify CLI 4.7.0 requires [events] and [[events.subscription]] even when app does not use Events API

Webhooks and Events
,
1

I’m developing a Shopify app on Windows with Shopify CLI 4.7.0.

My app uses normal webhooks only. shopify.app.toml includes valid [webhooks] subscriptions, but no Events API configuration.

When I run:

npm run dev

which runs:

shopify app dev

I receive:

Validation error in shopify.app.toml:

I then added this minimal section:

events
api_version = "unstable"

After that, running npm run dev produces:

Validation error in shopify.app.toml:

I don’t want to add a dummy [events.subscription], because that would require a real event topic and endpoint and would change the app’s behavior.

My app already has these webhook subscriptions:

[webhooks]
api_version = "2026-01"

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

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

[[webhooks.subscriptions]]
topics = ["app_subscriptions/update"]
uri = "/webhooks/app/app_subscriptions/update"

Questions:

  1. Is this a Shopify CLI 4.7.0 validation regression?
  2. Should events be optional when the app has no Events API subscriptions?
  3. Is downgrading to CLI 4.6.0 the correct workaround until this is fixed?

According to the documentation, Events is developer-preview/unstable and production apps should continue using webhooks when Events is not needed:

2

Please see the below:

4

Hey folks!

Closing the loop here: we’ve released a fix, and the issue is now resolved. Thank you for your patience!