CUSTOMER_TAGS_ADDED webhook not firing when tags added via Admin UI

Webhooks and Events
1

Hi,

I’ve been debugging an issue where the CUSTOMER_TAGS_ADDED webhook topic does not fire when tags are added manually through the Shopify Admin UI. After thorough testing I’m confident this is a bug.

Setup:

  • API version: 2025-10
  • Webhook registered via GraphQL (webhookSubscriptionCreate)
  • Topic: CUSTOMER_TAGS_ADDED
  • Delivery verified using webhook.site

What works:
Adding a tag via the tagsAdd GraphQL mutation fires the webhook correctly and immediately.

What doesn’t work:
Adding a tag manually through the Shopify Admin UI (opening a customer, adding a tag, saving) produces no webhook event at all.

Steps to reproduce:

  1. Register a CUSTOMER_TAGS_ADDED webhook via GraphQL webhookSubscriptionCreate
  2. Open a customer in the Shopify Admin UI, add a tag and save
  3. Observe: no webhook fires
  4. Add a tag to the same customer via the tagsAdd GraphQL mutation
  5. Observe: webhook fires correctly

Expected behavior:
CUSTOMER_TAGS_ADDED fires regardless of whether the tag was added via the Admin UI or the API.

Why this is a critical issue:
Since 2025-01, tags were removed from the CUSTOMERS_UPDATE payload, and CUSTOMER_TAGS_ADDED was introduced as the replacement. But if it only fires for direct tagsAdd API calls and not Admin UI actions, there is no way for apps to react to tag changes made by merchants manually — which is a very common use case. This is a significant regression with no workaround.

Has anyone else reproduced this? Can Shopify confirm this as a bug?

1 Like
2

Hey @MichaelB, I tested this and couldn’t replicate it. CUSTOMER_TAGS_ADDED fired for both the mutation and Admin UI on my end.

To narrow it down, can you share more context on your app configuration:

  • what OAuth scopes your app has
  • What plan is a store on (to see if protected customer data could be a factor)
  • What app distribution type do you have?

Also curious how you’re registering the webhook. Are you using TOML or webhookSubscriptionCreate? If you can share the config (either the TOML block or the mutation), that’d help along with what API version the app has configured for webhooks (this can be different than the API version used for admin API calls)

Once you’re confident everything is configured properly, if it’s still not firing, open the developer console to the network tab in the admin and grab the x-request-id from the mutation that is sent when you save the customer after adding the tag. We can see if we can trace any details from our logs to troubleshoot that further.

If all of this fails, the next steps would be to reach out to our support teams directly in the help center so they can look in to the specific configurations in more detail.

3

Hey @MichaelB, are you still experiencing this issue, or can I mark this as solved?

4

Hi,

I’ve been debugging the CUSTOMER_TAGS_ADDED webhook and noticed it doesn’t fire when tags are added from the Shopify Admin UI, only when using the tagsAdd API mutation.

I’ve already identified the cause and implemented a reliable workaround for apps that need to track customer tag changes.

If you’re dealing with this issue or need help implementing the fix, feel free to message me.

5

@Francis_Justin care to share what you’ve found and the workaround? I’m sure other developers in the community would appreciate it!

1 Like
6

Hello @KyleG-Shopify , sorry for the late response.

I’ve tried it again and it looks, that it’s working fine.

Thanks for your cooperation.

1 Like