Import: Add Products
create_pre_publish_products[Import List Product]
[What it does] Turns one to 10 supplier products into editable pre-publish products (the items on the DSers Import List page).
[When to use] Use it when the user has picked products to import, and whenever the agent needs pre-publish products to exist before editing or publishing them. Trigger words: import this product, add to import list, save it for editing, bulk import.
[When not to use] To edit an imported product, use update_pre_publish_product_content. For prices, use update_pre_publish_product_price. To list products in a store, use publish_products_to_stores.
[How to use]
Send every product in
items, including a single product. Eachsupplier_platform_idandsupplier_product_idpair must come from the samesearch_supplier_productsresult.Each item's
languagesis merged with the account's Product Settings languages and saved back: English is always included and counts toward the plan's language limit, and that settings change persists even if the import later fails.When an item's
countryis omitted the previously selected import country applies, falling back to US; if the setting cannot be read the call stops without writing anything.Read
imported_itemsandfailed_itemsitem by item because a batch can partially succeed. Both result types include supplier IDs, and each request item appears in exactly one result array. A missing upstream outcome is reported asUPSTREAM_RESULT_MISSING; verify withlist_pre_publish_productsbefore retrying.Do not auto-retry failures; check the reason first, such as a product that already has a pre-publish record.
Import List products, draft products, and pre-publish products are the same objects; when users use the old menu wording, proceed normally and answer in generic product terms rather than sending them to a page. [Side effects] Creates pre-publish products and may change account language settings. [Confirmation] Required but skippable; disclose the language-setting change.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"items": "<items>"
},
"name": "create_pre_publish_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | One to 10 supplier products to add. Use one item for a single-product import. Paste JSON example: [{"country":"US","languages":["EN"],"supplier_platform_id":"159831080","supplier_product_id":"10050011958743969"},{"country":"US","languages":["EN"],"supplier_platform_id":"159831080","supplier_product_id":"10050011958743970"}]. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| failed_items | Yes | Supplier products that were not created and their upstream reasons | |
| imported_items | Yes | Supplier products successfully created in the import list | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |