How to add Compliance Webhooks?

Shopify App Store
1

Hello everyone. I’m running around trying to add Compliance Webhooks, I’m looking all over the partner dashboard and I can’t find the fields. . May anyone please tell me how I can add the webhooks urls I already have? Simply trying to find the fields. I’m new at this, I apologize.

config link
config link1168×737 99.7 KB

2

Hi @user310

You can add it via the shopify.app.toml file. After configuring the required webhooks, simply run the command npm run deploy.

图片
图片1387×603 43.3 KB

3

@user310, you can configure compliance webhooks in shopify.app.toml file.

[webhooks]
api_version = "2026-01"

[[webhooks.subscriptions]]
uri = "/gdpr/customer_data_request"
compliance_topics = ["customers/data_request"]

[[webhooks.subscriptions]]
uri = "/gdpr/customers_redact"
compliance_topics = ["customers/redact"]

[[webhooks.subscriptions]]
uri = "/gdpr/shop_redact"
compliance_topics = ["shop/redact"]
4

I know this might sound like a dumb question, but where can I locate the file? Like is there a specific place I can go to access it? (shopify.app.toml)

5

Firstly， you need to use shopify cli to create an app ,then you will find the file.

6

@user310

Are you using the Shopify app template?
I recommend you to learn it first, it will be very helpful for you to develop public apps

Shopify API, libraries, and tools

7

Thank you everyone! I followed your resources and learned everything and was able to add the compliance webhooks. Thanks again to everyone.

8

Thank you! Using this and other resources I figured it out!

9

Anyone know how to add these compliance web hooks if you are not using the CLI? For example, I am making an API based app which is not embedded.

It doesn’t have a TOML file and the options are not in the developers centre (anymore)

10

You can still use the CLI/toml file even if its not embedded

11

@steve_winn Question may be old but for anyone else…

You do have to use the CLI to generate the compliance URIs for the TOML file.

Quick and easy though even if you have already set up your app and just need the compliance.

Open a terminal/PowerShell on your local machine. Run:

node -v
npm -v

If “command not found” or older versions:

  • Download Node.js LTS from https://nodejs.org/
  • Install it (Windows: .msi installer, Mac: .pkg installer)
  • Restart your terminal
  • Re-run node -v to verify

npm install -g @shopify/cli@latest

Verify:
shopify version

Run:
shopify auth login

The CLI expects a project folder. Doesn’t have to be your real codebase — can be a stub folder just for managing config.

mkdir ~/Documents/your-app
cd ~/Documents/your-app

Now connect your app you already created in your dashboard to that folder so it will create that TOML so you can edit it:
shopify app config link

CLI prompts:

  • “Which existing app is this for?” → select YOUR APP from the list
  • “Configuration file name” → press Enter (defaults to shopify.app.toml)

Add your compliance subscription block at the bottom (or under [webhooks]):

[[webhooks.subscriptions]]
compliance_topics = [ "customers/data_request", "customers/redact", "shop/redact" ]
uri = "https://your-custom-server/webhooks/compliance"

Save and run:
shopify app deploy

Hope that helps anyone else here that created their app and did not use CLI since 2026!

12

Thanks. This is what I had to do in the end.