I can't register with my shopify.app.toml file

Webhooks and Events
1

Hi there

I have completed my compliance webhook with some basic requirements, such as returning 200 when valid and 401 when invalid. In addition, I have tested with a webhook trigger, and it returns success: “Success! Webhook has been enqueued for delivery.” But when I run “shopify app deploy,” the webhooks are still not registered in the newest release, and it returns “no changes in configuration.” I don’t know what I am missing. Can anyone help me? Here is my shopify.app.config.

`name = “Emerge App”
client_id = “MY_CLIENT_ID”
application_url = “https://emergeapp.net”
embedded = false

[auth]
redirect_urls = [
“https://spf.emergeapp.net/Oauth2LandingPage/index.html”,
“https://spf.ap.emergeapp.net/Oauth2LandingPage/index.html”,
“https://spf.emergeapp.com.cn/Oauth2LandingPage/index.html” ]`

[access_scopes]
scopes = "read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_customers,write_customers,write_inventory,read_inventory,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,write_locations,read_locations,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,write_order_edits,read_order_edits,read_orders,write_orders,read_product_listings,write_product_listings,read_products,write_products,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders"

[webhooks]
api_version = "2026-01"

[[webhooks.subscriptions]]
compliance_topics = ["customers/redact", "customers/data_request", "shop/redact"]
uri = "https://MY_HOST_AND_PORT/api/v1/shopifyWebhooks"

2

Hi @Gigi_Nguyen

Your TOML config looks correct, and “no changes in configuration” is not an error.

That message means the CLI compared your shopify.app.toml against what’s already deployed and found no delta. Since your webhook trigger test is returning "Success! Webhook has been enqueued for delivery", your compliance webhooks are registered and working.

To confirm, check: Partner Dashboard → Your app → App setup → Compliance webhooks section

You should see all three topics listed there. Note that compliance webhooks registered via shopify.app.toml are app-level (not store-level), so they appear in the Partner Dashboard rather than in the store admin — which can make them feel invisible compared to regular webhooks.

Your TOML structure is exactly right, for reference:

[webhooks]
api_version = "2026-01"
[[webhooks.subscriptions]]
compliance_topics = ["customers/redact", "customers/data_request", "shop/redact"]
uri = "https://your-host/api/v1/shopifyWebhooks"

If they’re not showing in the Partner Dashboard, make sure your CLI is up to date (npm install -g @shopify/cli@latest) and try a fresh shopify app deploy.

Docs: Mandatory webhooks configuration

3

HI @Liam-Shopify
Thanks for your reply. But I can’t find the Compliance webhooks section that you mentioned. I have gone into my app, but there is no section like App setup or configuration as I saw on the internet.

image
image1230×567 39.4 KB

In addition, I have tried running an automated check in Manage Submission, and it still says I did not pass the compliance webhook and webhook verification. Can you guide me more clearly here? Thank you very much

4

its in your dev dashboard and check that in your version part

5

image
image764×829 42.2 KB

I absolutely do not have it. I have searched, and if it is successful, it should appear below the webhooks section, right? So does it mean I have not registered successfully yet? It’s so weird. With the correct TOML structure, I should be successful, but I am not.

6

Hi @Gigi_Nguyen

Sorry - I was wrong about the partner dash, the best indicators that the compliance webhooks are correctly registered are:

  1. shopify app deploy reports “no changes” (the config matches what’s deployed)
  2. The webhook trigger test returns "Success! Webhook has been enqueued for delivery"
7

Hi @Liam-Shopify

I have satisfied the above two conditions, but it still does not work. I read the documentation again and saw a sentence: “You must subscribe to compliance webhooks before publishing your app.” I want to ask whether “publishing” here means when we choose a public app or custom app in distribution, or just submit for review? Because I chose to publish the app before I completed my webhooks, do I need to create another app and start again?

8

Hi @Gigi_Nguyen

Have you tried subscribing to other webhooks? Do they display correctly?

9

Hi @Eric_Han @kyle_liu @Liam-Shopify
I reran the config file again today, and it worked (I still don’t know why it did not work before). Thanks for all your support.