Skip to main content

Bulk Map Store Products

PUT 
/api/storefront/instances/:id/products/map

Map many store products in one call, with ONE EXPLICITLY CHOSEN TARGET PER ROW. This is the shared bulk-mapping contract every SKU.io sales channel implements, byte-identical.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Body:

  • mapping — array, required, at least one entry. Each entry:
    • mapping[].sales_channel_listing_id — string, required. On this channel that is the STORE SKU (the store keys its catalogue by SKU).
    • mapping[].mapped_sku — string or null, required to be present. The SKU of the SKU.io product to map to. Send null (or an empty string, which is treated as null) to UNMAP that row.
    • mapping[].subscription_offering_id — integer or null, optional. Not supported on this channel; leave it out.

Use this to correct many matches at once. POST /bulk-map is the different, cheaper thing: auto-matching by SKU with no chosen target.

Mapping also relinks already-imported order lines carrying those SKUs, so orders that arrived before the mapping existed stop showing as unlinked.

Permission: integrations.update.

Authentication: Bearer token (session or PAT).

Request​

Responses​

OK

Response Headers
    Content-Type