MCP

optimize.import_product

Import one Printify or Printful product into the account as a saved design.

EffectwritesReachesoutside VaybelScopeoptimize:writePlanGrowthRate limit10/minIdempotent

Reads the product from the connected provider, saves it as a design with its colorways and a thumbnail, and links the product's existing sales-channel listing when there is one. The import itself uses no credits; later design and listing work on the imported product is charged as usual.

Parameters

providerstringRequired

"printify" or "printful".

product_idstringRequired

External product id from the provider.

shop_idstring

Optional. Printify-only — picks the shop when multiple are connected.

idempotency_keystring

Send the same key when retrying this exact call. A completed request replays for 24 hours without running or billing again.

callback_urlstring

An https URL that receives a signed completion event when the work finishes, so you can skip polling. See Webhooks.

Returns

handlestring

Opaque async handle. Pass to optimize.get_generation.

status"pending"

category"import"

task_type"import_optimize_product"

messagestring

Describes the optimize.get_generation(..., wait_sec=...) contract.

Request

json

{
  "name": "optimize.import_product",
  "arguments": {
    "provider": "printify",
    "product_id": "6718e3a2b1c4d5e6f7a8b9c0"
  }
}