Skip to main content

Create SKU.io Product from Variant

POST 
/api/faire/instances/:integrationInstance/products/:option/create-sku-product

Creates a new SKU.io product from a Faire variant's data and links the variant to it via a product_listings row. Used by the Create New SKU Product action in the per-row mapping modal.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Behavior:

  • If a SKU.io product with the same SKU as the Faire variant already exists, links to that product instead of creating a duplicate (the response sets linked_existing: true).
  • Otherwise, creates a fresh Product row using the variant's SKU, name, and pricing data, then maps the variant to it.
  • The new product's SKU is made unique with a numeric suffix if the variant SKU collides with an unrelated product.

Path Parameters:

  • integrationInstance — Faire integration instance ID. Returns 404 if the variant doesn't belong to this instance.
  • option — Faire product option (variant) ID.

Body: None — all data is derived from the Faire variant.

Response shape: Returns the updated Faire product option object (same shape as GET .../products/:option) with product populated, plus:

  • linked_existing (bool) — true if an existing SKU.io product was reused.
  • message (string) — Human-readable status.

Errors:

  • 404 — The variant does not belong to the given integration instance.
  • 422 — The variant is already mapped to a SKU.io product. Unmap it first.

Note: faire_product_id is the Faire-issued product ID (e.g. p_3bz2tdhtkq), sourced from the parent FaireProduct. It is NOT the internal faire_product_options.faire_product_id foreign key.

Request​

Responses​

Created

Response Headers
    Content-Type