Create Product Template
POST/api/v2/sales-channels/:salesChannel/product-templates
Creates a product template holding reusable per-category defaults applied when publishing products to this sales channel.
name is required. description, sales_channel_category_id, sales_channel_listing_profile_id, is_default and fields are optional.
is_default marks the template preselected when publishing a product in this category. At most one template per sales channel + category can be the default — setting it here clears the flag from any other template in the same category.
Each entry in fields sets a default for one attribute and targets EITHER a channel category field (sales_channel_category_field_id) OR a core listing field by name (core_field_name, e.g. Title / Description / Price) — not both.
source_type is one of product_field, product_attribute, static, expression. source_value is the product column, attribute id, literal, or expression to read.
A multi-value attribute takes a JSON array literal as its static source_value (e.g. ["Feature one","Feature two","Feature three"]); a scalar source such as expression can only ever produce one value and will fail a minimum-value rule.
Authentication: Requires Bearer token with the products scope.
products:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Request
Responses
- 201
- 401
- 403
- 404
- 422
- 429
Created
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Content
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.