Catalogue Updated

Sent BY Ewity TO your app's registered webhook endpoint(s). The
path on this page exists only for docs grouping. Identify the event
by the X-Ewity-Event header.

Fires when one or more catalogue items at one or more of the
install's online locations may have changed — stock crossing in/out
of "in stock", storefront toggles, bulk imports. The event is
uniform across causes: data.items is a list of
(online_location_id, product_id, variant_id) triples; re-fetch via
the catalogue lookup endpoint to learn the new state. Changes that
pile up between deliveries are coalesced into one webhook with a
longer items array.

Envelope twin of the legacy CatalogueUpdated event. The same
payload may be delivered more than once — the lookup-and-upsert
pattern is naturally idempotent.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
string
enum
Allowed:
string
company
object

The merchant business — {id, name, domain}.

install
object

The app install — {store_id, external_account_id}.

data
object

{items: [{online_location_id, product_id, variant_id}], occurred_at: string}.

Headers
string
enum
required

Always catalogue.updated for this event.

Allowed:
string
required

Unique delivery id (same as the envelope id).

string

Present in signature verification mode (the default); see the webhooks overview.

Response
2XX

Receiver acknowledged. Non-2xx and connection failures are logged but not retried — deliveries are best-effort single attempts.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here!