product_create
Create a product by providing name, slug, and price. Optionally add attributes, translations, or legacy fields. Returns the new product ID.
Instructions
Create a new product (POST /products on ecommerce v1). Required: name, slug, price (Voog rejects POST without these). Three argument shapes (combinable):
attributes: flat object of root-level product fields. Allowed keys: name, slug, price, sale_price, status, description, sku, stock, reserved_quantity, category_ids, image_id, asset_ids, physical_properties, uses_variants, variant_types. Note: POST usesasset_ids(list of int), unlike PUT which usesassets:[{id}].translations: nested {field: {lang: value}} for translatable fields (name, slug, description). Each field-language pair must be non-empty.fields(legacy v1.1 shape): flat 'name-et', 'slug-en' keys — auto-routed to translations. Validates status enum {'draft', 'live'} and rejects unknown attribute keys. The POST result includes the newly assigned product id. Price fields (price,sale_price,effective_price) are net or gross depending onsettings.price_entry_mode. Callecommerce_settings_getto determine the mode. For customer-facing pricing always useeffective_priceand verify the mode first.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | Yes | ||
| attributes | No | Root-level product fields. Required (in this or in `translations`/`fields`): name, slug, price. | |
| translations | No | Nested {field: {lang: value}}. Allowed fields: name, slug, description. | |
| fields | No | Legacy v1.1 shape: 'name-et', 'slug-en' keys. Auto-routed to translations. |