Shopify App Dev Localhost Error: Invalid Webhook URI Fix

Problem

When running shopify app dev, you encounter the following error:

Error:

Invalid value: "https://localhost:50744/webhooks/app/scopes_update" for: "uri"

Invalid value: "https://localhost:50744/webhooks/app/uninstalled" for: "uri"

This error stops your local development server from starting.

Cause

The Shopify CLI attempts to register all webhooks defined in your shopify.app.toml file upon startup. A localhost URI is not a valid destination for a real Shopify webhook, causing the validation to fail.

Solution

You must prevent the CLI from trying to register these webhooks in a local environment. This is done by removing the webhook subscription definitions from your shopify.app.toml file.

Step 1: Open shopify.app.toml

Locate and open the shopify.app.toml file in the root directory of your app.

Step 2: Modify the File

1. Delete the [[webhooks.subscriptions]] blocks from the file.

2.Change application_url from to "http://localhost"

Before:

1# Learn more about configuring your app at https://shopify.dev/docs/apps/tools/cli/configuration
2
3client_id = "5be9e8xxxxxxxxea7f2a9a1"
4name = "Max AI: Google Feed Ascend"
5application_url = "https://example.com"
6embedded = true
7
8[build]
9automatically_update_urls_on_dev = true
10include_config_on_deploy = true
11
12[webhooks]
13api_version = "2025-10"
14
15  [[webhooks.subscriptions]]
16  topics = [ "app/uninstalled" ]
17  uri = "/webhooks/app/uninstalled"
18
19  [[webhooks.subscriptions]]
20  topics = [ "app/scopes_update" ]
21  uri = "/webhooks/app/scopes_update"
22
23[access_scopes]
24# Learn more at https://shopify.dev/docs/apps/tools/cli/configuration#access_scopes
25scopes = ""
26optional_scopes = [ ]
27use_legacy_install_flow = false
28
29[auth]
30redirect_urls = [ ]

‍

After:

1# Learn more about configuring your app at https://shopify.dev/docs/apps/tools/cli/configuration
2
3client_id = "5be9e84xxxxxxxx4ea7f2a9a1"
4name = "Max AI: Google Feed Ascend"
5application_url = "http://localhost"
6embedded = true
7
8[build]
9automatically_update_urls_on_dev = true
10include_config_on_deploy = true
11
12[webhooks]
13api_version = "2025-10"
14
15# The following webhook subscriptions have been removed.
16# They cause an error in localhost mode because Shopify cannot register a webhook to a local URI.
17# [[webhooks.subscriptions]]
18# topics = [ "app/uninstalled" ]
19# uri = "/webhooks/app/uninstalled"
20
21# [[webhooks.subscriptions]]
22# topics = [ "app/scopes_update" ]
23# uri = "/webhooks/app/scopes_update"
24
25[access_scopes]
26# Learn more at https://shopify.dev/docs/apps/tools/cli/configuration#access_scopes
27scopes = ""
28optional_scopes = [ ]
29use_legacy_install_flow = false
30
31[auth]
32redirect_urls = [ ]