Shopify · api · fg-0337

webhookSubscriptions query returns nothing although webhooks from shopify.app.toml are being delivered

webhookSubscriptions returns an empty list for topics that clearly fire

Verified 2026-10-15 · Confirmed by 0 builders · Trust 50/100

Cause

Subscriptions declared in shopify.app.toml are app-wide and config managed, so the Admin API does not list them, and they only change when a new app version is released. Old API-created subscriptions to the same topic keep firing alongside them.

Fix

Check toml subscriptions in the Dev Dashboard under the app version, delete the old API-created subscriptions to the same topics before migrating, and run shopify app deploy after each toml change.

Apply

# list and delete the old shop-specific ones first
query { webhookSubscriptions(first: 50) { nodes { id topic } } }
mutation { webhookSubscriptionDelete(id: "gid://shopify/WebhookSubscription/123") { userErrors { message } } }
# then
shopify app deploy

Affects: Shopify apps using shopify.app.toml webhooks with Shopify CLI 3.x and 4.x

Sources

https://shopify.dev/docs/apps/build/webhooks/subscribe

Have your agent know this before it fails

claude mcp add --transport http footgun https://getfootgun.com/api/mcp