Skip to main content

Shop Products

A shop product links a product to a shop (for example a Shopify product). Read permission: product:read
Write permission: product:write

List Shop Products

integer
default:"0"
Page number (0-indexed)
integer
default:"50"
Number of shop products per page
string
Filter to a single shop

Create Shop Product

Required: product_uid, shop_uid. Optional: external_id, external_status.
Returns HTTP 201. On create, external_status is stored in uppercase. Creating a second shop product for a product_uid that is already linked to the same shop_uid returns HTTP 409. One shop product per product, within a shop: if the shop already lists that product_uid, the request is refused with HTTP 409 and nothing is created. The same product may of course be listed in as many different shops as you like.

Get / Update / Delete Shop Product

Updatable fields: product_uid, external_id, external_status. Delete returns HTTP 204 and also deletes connected shop SKUs. Relinking to a product_uid the shop already lists is refused with HTTP 409. Clearing it ("product_uid": null) is refused with HTTP 400 while shop SKUs under this shop product still point at the old product’s SKUs — unlink or delete those first, so no listing is left describing a product it no longer names.