Create SKU.io Product from Amazon Product

POST 
/api/amazon/:integrationInstance/products/:product/create-sku-product

Single-row variant of the bulk Create-SKU-Products endpoint. Used by the per-row Create SKU.io Product button in the unified mapping modal (Amazon parity with Faire/Shopify).

Authorization

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

Behavior:

• If the Amazon product already has a mapping (productListing), returns HTTP 422.
• If a SKU.io products.sku row already exists matching the Amazon seller_sku, the existing product is linked (no duplicate is created) — linked_existing: true in the response.
• Otherwise, a new SKU.io product is created and mapped.

Returns HTTP 201 in both link and create cases, with the refreshed Amazon product object.

Named route: amazon.products.create-sku-product.

Request

Responses

201

Created

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

422

Unprocessable Entity

Response Headers

Content-Type

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.