Which webhook should I use to detect product additions/removals for sales channels: productListings or productPublications?

Webhooks and Events
1

I’m trying to detect when products are added to or removed from our sales channel that we’re developing. I’m unsure which webhook would be more appropriate for this purpose - should I be using productListings or productPublications webhooks?

We need to track when products are made available or unavailable for sale on our custom sales channel, and I’d like to know which webhook endpoint would be the correct one to monitor for these events.

2

Hi @Shota_Yamamoto

To detect when products are added to or removed from your custom sales channel, you should use the product listings or product feed webhooks, not product publications.

Here’s the difference:

  • Product Listings / Product Feeds webhooks notify you when a product is made available or unavailable for sale on your specific sales channel. These are the correct webhooks to use for tracking the availability of products on your channel.
  • Product Publications webhooks are more general and relate to the publication of products to publications, which may not directly map to your sales channel’s product availability.

For a sales channel, you should subscribe to the following webhook topics:

  • PRODUCT_LISTINGS_ADD and PRODUCT_LISTINGS_REMOVE (or the newer product feed equivalents)
  • Alternatively, for more advanced localization and market support, use PRODUCT_FEEDS_INCREMENTAL_SYNC and PRODUCT_FEEDS_FULL_SYNC webhooks.

These webhooks will notify your app whenever a product is published (added) or unpublished (removed) from your sales channel.