Skip to main content

Map Purple Dot Variant to Product

POST 

/api/purple-dot/:instance/variant-mappings

Point a Purple Dot SKU and/or Shopify variant at a SKU.io product. Held pre-order lines for that variant that had no product are matched and become backorder demand.

Required scope: inventory:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body: external_sku (string, required without shopify_variant_id), shopify_variant_id (string, required without external_sku), product_id (integer, required, an existing product). Requires integrations.update.

422 not_allowed — a pre-order sync or matching-key change is running for this connection (they share the connection's matching lock, so a running poll can't overwrite the new mapping). Nothing is saved; retry in a minute.

Request​

Responses​

Created

Response Headers
    Content-Type