> ## Documentation Index
> Fetch the complete documentation index at: https://docs.copyfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# import_product_to_shopify

> Copy a product found with Copyfy into your Shopify store, as a draft by default.

Creates a product in the Shopify store connected to your Copyfy account, like **Import to Shopify** on the dashboard's export page. Copyfy copies the product's title, description, images (up to 10), product type, and tags, with one variant at the product's lowest price. The product is created as a **draft**, hidden from your customers until you review it in Shopify, unless you ask for it to go on sale right away with `status: "active"`.

Copyfy tells your assistant to call it only when you ask to import a product, and marks it as a tool that writes to an outside service, so your client can ask you first. Each call creates a new product in your store.

**Cost:** 1 credit, set aside when the call starts and given back if the import fails. No AI credit is spent.

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `product_id` | integer or numeric string | Required. Copyfy product id, from [`search_products`](https://docs.copyfy.io/tools/search-products), [`get_product`](https://docs.copyfy.io/tools/get-product), or [`get_shop`](https://docs.copyfy.io/tools/get-shop). |
| `title` | string | Up to 255 characters. Default: the product's title. |
| `price` | number | 0.01 to 1,000,000, in your store's currency. Default: the product's lowest variant price, copied without currency conversion. |
| `compare_at_price` | number | Strikethrough price, higher than `price`, up to 1,000,000. Default: none. |
| `description` | string | Plain text, up to 10,000 characters. A blank line starts a new paragraph. Default: the product's description. |
| `status` | string | `draft` (default) or `active`. |
| `include_images` | boolean | Copy the product's images, up to 10. Default `true`. |

Copyfy does not copy the source store's vendor name: Shopify fills in your store's name.

## Example

```json Tool call theme={null}
{
  "name": "import_product_to_shopify",
  "arguments": { "product_id": 4419021 }
}
```

```json Result theme={null}
{
  "job": { "id": "shp_mcp-6f1c2a9e0b7d4c3a8e5f1b2c3d4e5f60", "kind": "shopify_import", "status": "succeeded" },
  "shop_domain": "my-store.myshopify.com",
  "product": {
    "title": "Self-Cleaning Pet Brush",
    "price": 24.9,
    "compare_at_price": null,
    "status": "draft",
    "images_count": 6,
    "source_currency": "USD"
  },
  "shopify_product": {
    "id": 8123456789012,
    "handle": "self-cleaning-pet-brush",
    "title": "Self-Cleaning Pet Brush",
    "status": "draft",
    "admin_url": "https://admin.shopify.com/store/my-store/products/8123456789012"
  },
  "created_without_images": false,
  "notice": "The price comes from the source store (USD) without currency conversion. If the user's Shopify store sells in another currency, change it in the Shopify admin."
}
```

When Shopify takes longer to answer, `job.status` is `running` with `poll_after_seconds`, and [`get_job_status`](https://docs.copyfy.io/tools/get-job-status) returns `shopify_product` once the product exists. Wait for the job to end before importing again, since every call creates a new product. If the job reports `unknown`, Copyfy lost track of the import: check the products in your Shopify admin first, because the product may already be there.

## Result fields

| Field | Type | Description |
| - | - | - |
| `job` | object | `id`, `kind` (`shopify_import`), `status` (`succeeded` or `running`), and `poll_after_seconds` while it runs. |
| `shop_domain` | string | The Shopify store that receives the product. |
| `product` | object | What Copyfy sent to Shopify: `title`, `price`, `compare_at_price`, `status`, `images_count`, and `source_currency`, the currency of the store the product comes from. |
| `shopify_product` | object | Once the product exists: its `id`, `handle`, `title`, `status`, and `admin_url`, its page in the Shopify admin. |
| `created_without_images` | boolean | Once the product exists: `true` when Shopify refused the images and Copyfy created the product without them, as the dashboard does. |
| `notice` | string | Present when the price comes from the source store, copied without currency conversion. |

## Errors

| Code | When |
| - | - |
| [`not_found`](https://docs.copyfy.io/errors#not_found) | No Copyfy product has this id, or the product or its store is no longer available. |
| [`invalid_arguments`](https://docs.copyfy.io/errors#invalid_arguments) | Copyfy has no price for the product and `price` is missing, `compare_at_price` is not higher than `price`, or Shopify refused the product: the message gives Shopify's reason. |
| [`shopify_not_connected`](https://docs.copyfy.io/errors#shopify_not_connected) | No Shopify store is connected to your Copyfy account. The error includes `connect_url`. |
| [`shopify_reconnect_required`](https://docs.copyfy.io/errors#shopify_reconnect_required) | Shopify refused Copyfy's access to your store. The error includes `shop_domain` and `reconnect_url`, which opens the reconnection flow that matches how the store was connected. |
| [`rate_limited`](https://docs.copyfy.io/errors#rate_limited) | Shopify is limiting requests to your store. Retry after `retry_after_seconds`. |
| [`service_unavailable`](https://docs.copyfy.io/errors#service_unavailable) | Copyfy or Shopify could not create the product. When the error includes `job_id`, Copyfy could not confirm whether the import started, and the MCP credit stays set aside until the import settles it: check that job with [`get_job_status`](https://docs.copyfy.io/tools/get-job-status) before importing again. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.