Cannot create customer.tags_added webhook

Webhooks and Events
1

Creating customer.tags_added webhook fails. When I try to create with this payload using the REST endpoint. What am I doing wrong? customers/update no longer includes the tags and I can’t register the customer.tags_added

{
    "webhook": {
        "topic": "customer.tags_added",
        "address": "https://perisarcal-forkedly-alexander.ngrok-free.dev/api/integrations/shopify/webhooks",
        "format": "json"
    }
}

I get this error

{
    "errors": "Could not find the webhook topic customer.tags_added"
}
2

You should also move over to GraphQL as REST is deprecated.

3

Hey Joel! Just tested this on my end and can confirm - customer.tags_added doesn’t exist in the REST API, which is why you’re getting that “Could not find the webhook topic” error. It’s GraphQL-only.

Back in January when the 2025-01 API version dropped, Shopify removed the tags field from customer webhook payloads and added these new tag-specific webhooks (CUSTOMER_TAGS_ADDED and CUSTOMER_TAGS_REMOVED). They’re only available in GraphQL though.

You can subscribe to that topic with the below mutation:

mutation {
  webhookSubscriptionCreate(
    topic: CUSTOMER_TAGS_ADDED
    webhookSubscription: {
      callbackUrl: "https://your-app.com/webhooks"
      format: JSON
    }
  ) {
    webhookSubscription {
      id
      topic
    }
    userErrors {
      field
      message
    }
  }
}

I tried this in my test store and it works - creates the webhook subscription without any issues. Here’s the webhook subscription docs if you need more details an structuring your mutation.

As Luke mentions above, REST is now in legacy mode meaning it won’t receive any new features. We recommend planning your migration to GraphQL sooner rather than later.

Let me know if the above works for you or if you need help with the GraphQL setup!

4

Hey @Joel_Funu, just checking in to see if the above from myself and Luke helped? If you have any other questions feel free to thread them here!