Create or duplicate product
ps_create_product
Adds a new product, or a copy of an existing one, as a switched-off draft that you check before customers see it.
Free TellMyShop Audit: No. This tool is only in the paid version of TellMyShop. The free TellMyShop Audit has only tools that read your store.
Ask Claude
„Add a new product: Nova garden lamp, black, 149.99 gross, category Garden lighting, 20 in stock. Don't publish it yet.”
Example preview
New product "Nova garden lamp, black" (text in all languages). Price 149.99 PLN gross / 121.94 net, VAT 23% (most used rate). Category: Garden lighting (default). Stock: 20. Status: OFF (draft). Images: none, add them with ps_manage_product_images.
Technical details
action=create adds a new product: name (required), descriptions, meta title and description, reference, EAN, gross or net price, tax rules group (default: the most used rate), categories (the first is the default; default Home), weight, manufacturer, initial quantity. The texts are written to all languages; translate them later with ps_update_product_content. action=duplicate copies a product like Duplicate in the back office: categories, combinations, features, specific prices and, with with_images, images; the copy can get a new name and reference. A new product and a copy start SWITCHED OFF unless active=true; switch them on later with ps_set_product_redirect (activate=true). Images: ps_manage_product_images.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: create | duplicate | yes | create | duplicate. |
| shop_id | integer | no | Shop ID in a multistore installation. Defaults to the shop in the connector address. IDs are listed by ps_get_shop_info. |
| source | string | when: action=duplicate | duplicate: the product to copy. Product the way a person refers to it: "id:123", "ref:ABC-1", "ean:5901234123457", a product URL from the shop, a bare ID (1–7 digits), an EAN (8/12/13 digits) or a reference. Max 300 characters. |
| name | string | when: action=create | Name (create: required; duplicate: defaults to the source name). Max 128 characters. |
| description | string (HTML) | no | create: description (HTML). Max 65,000 characters. |
| description_short | string (HTML) | no | create: short description (HTML). Max 21,844 characters. |
| meta_title | string | no | create: meta title. Max 255 characters. |
| meta_description | string | no | create: meta description. Max 512 characters. |
| reference | string | no | Product reference (code). With duplicate: the new reference of the copy. Max 64 characters. |
| ean13 | string | no | create: EAN. |
| price_gross | number | no | create: gross price in the shop currency. Range 0 to 10,000,000. |
| price_net | number | no | create: net price (instead of gross). Range 0 to 10,000,000. |
| tax_rules_group_id | integer | no | create: tax rules group (VAT rate); 0 = no tax. Default: the most used rate. |
| category_ids | array of integer | no | create: categories; the first one is the default category (default: Home). Max 30 items. |
| weight | number | no | create: weight (kg). Range 0 to 100,000. |
| manufacturer_id | integer | no | create: manufacturer. |
| quantity | integer | no | create: initial stock (default 0). Range 0 to 1,000,000. |
| with_images | boolean | no | duplicate: copy images. Default true. |
| active | boolean | no | Switch on right away (default no: the product stays a draft). |
| confirm | boolean | no | false (default) returns a preview and saves nothing. true executes, only after the user approved the preview, together with change_token. |
| change_token | string | when: confirm=true | Token from the preview. Required with confirm=true. Valid 30 minutes, single use, bound to the previewed arguments and data state. |
Limits
One product per call. New product and copy are off by default. Texts go to all languages at once. ps_revert_change deletes the created product only if it is in no order. Images are added separately. Amounts are in the shop currency.
What you see before anything is saved
Claude first calls the tool without confirming it. The module returns a preview (current and new values) and a single-use token valid for 30 minutes. Claude shows you the preview and saves the change only after your yes.
Related tools
- Manage product images ps_manage_product_images
- Switch product off or on, with redirect ps_set_product_redirect
- Update product content ps_update_product_content
- Revert change ps_revert_change
Use cases with this tool
Last updated: 2026-10-05