Cannot deploy shopify app (webhooks validation errors)

Shopify Apps

Topic summary

A developer is encountering webhook validation errors when trying to deploy their Shopify app, despite the configuration appearing correct and having worked previously.

Error Details:

  • The validation error occurs in the shopify.app.toml configuration file
  • Multiple webhook topics are configured (app/uninstalled, carts/create, carts/update, checkouts/create, orders/create, orders/update, products/update)
  • API version is set to “2024-07”

Identified Issue:
The uri field is set to a relative path (“/webhooks/”) rather than a full URL.

Solution Provided:
The URI must be a complete URL including the domain where the webhook server will run. This is necessary because webhooks are sent from Shopify’s servers, which cannot resolve relative URLs.

Status: The issue appears to be resolved with the suggested fix, though the developer questions whether a Shopify version upgrade may have caused the previously working configuration to break.

Summarized with AI on November 6. AI used: claude-sonnet-4-5-20250929.
1

Screenshot 2024-09-04 at 13.42.07.png
Screenshot 2024-09-04 at 13.42.07.png870×334 6.94 KB


[webhooks]
api_version = "2024-07"

[[webhooks.subscriptions]]
topics = [
"app/uninstalled",
"carts/create",
"carts/update",
"checkouts/create",
"checkouts/update",
"orders/create",
"orders/update",
"products/update"
]
uri = "/webhooks"

For some reason im getting a validation error. Everything seems to be in place and it worked before.

Did shopify upgrade version or something?

Thanks in advance.

2

The uri must be a full URL including the domain for where your webhook server will be running.
This is because the webhook will be sent from Shopify’s server and they would be unable to send it to a relative URL.