Partial Edit Product

Edit some properties (e.g. description, images, attributes) of a product that is not in the FREEZE or DELETED state. After editing the product, the latest product content (referred to as v2) will be resent for audit review. If the audit passes, v2 is published to the shop, otherwise, the existing product stays live and remains unchanged (keeping v1). However, edits to the price or inventory fields do not require a reaudit and will be immediately published on the platform. Use the Product status change webhook to keep track of the review status. Note:

• This API is applicable for all sellers.
• There may be a limit to the number of products you can relist per day. We recommend prioritizing key products first to ensure they get published. You can find your listing limit on the Seller Center homepage.
• If a draft or audit-review version exists, unedited fields will retain their values over those of the base (live) version.
• Updates are handled per top-level property, so all non-empty fields within an updated object must be supplied to prevent overwriting with blanks. For top-level properties (e.g. description, brand_id) that are not nested in an object, you can update them individually. Omitting these properties in the request will leave them unchanged. If you need to edit any nested property within an object, you must provide values for all nested properties of that object. Any omitted nested properties will be overwritten with blanks.
• If new mandatory product attributes were added by TikTok Shop after the creation of your product, ensure that you provide these attributes too. For global sellers: If you're using the local replication listing method, note the following sync rules: Sales attribute changes (in sales attribute id/name) must be synced to other markets. Therefore, you must provide the seller_sku and complete replicated_products data. The API call will fail if you don't provide these details. *New SKUs (new sales attribute value id/name) are optional to sync to other markets. To sync, please provide the seller_sku and complete replicated_products data. General changes are optional to sync to other markets. To sync, you only need to provide replicated_products.region. For Tokopedia sellers: Note that a product can have only one active version across all platforms at any time. If a product is live on both platforms, audit results for the latest version are handled as follows:
• Mixed audit results: If the product passes audit on one platform but fails on another, on the successful platform, the product will stay live and be updated with content from the latest version (v2), while on the failed platform, the product will be deactivated and hidden entirely.
• Audit failure on all platforms: If the product fails audit on all platforms, the existing product stays live and remains unchanged (keeping v1).

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

• US, EU and SEA: v2, represents the 7-level category tree. Important: For US, EU and SEA shops, you must pass v2 when using this API.
• Other regions: v1, represents the 3-level category tree.Default: v1 | certifications |[]object |N | |The list of certifications for your product. Max count: 10

As per TikTok Shop guidelines, certifications are required for certain restricted product categories. Retrieve the certification requirements for your product from the Get Category Rules API. Refer to TikTok Shop Restricted Products Policy for information on product category restrictions. | ^expiration_date |int |N |1741235047 |The expiration date of this certification expressed in unix timestamp (seconds) UTC+0. This field may be required for certain certifications. Use the Get Category Rules API to find out the requirements. | ^files |[]object |N | |A list of certification related files. | ^^format |string |Y |PDF |The format of the certification file. Only PDF is supported. | ^^id |string |Y |tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe |The ID of the certification file. Use the Upload Product File API to upload the files first and obtain the corresponding file ID. | ^^name |string |Y |Certificate.pdf |The name of the certification file, including the file extension. | ^id |string |Y |7182427311584347905 |The ID to identify the type of certification required for the product category. Retrieve this value from the Get Category Rules API. | ^images |[]object |N | |A list of certification related images. | ^^uri |string |Y |tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe |The URI of the image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=CERTIFICATION_IMAGE. | description |string |N | |The product description in HTML format. Note:

• The content must conform to the HTML syntax. All HTML tags are accepted but to optimize display on the TikTok Shop product detail page, the system will automatically convert certain tags into alternative formats, such as rendering <table> tags as images.
• Max length: 10,000 characters.
• Image guidelines: You must use TikTok Shop image URLs. Max 30 <img> tags, each under 4000px with src, width, and height attributes.

Recommendations:

• If you are syncing a pre-existing description from another platform, include the full HTML source description here.
• Provide a detailed description, ideally over 300 characters.
• Include 3-5 key selling points, each under 250 characters, with supporting images.
• Use 1600x1600 px for the image dimensions. | external_product_id |string |N |172959296971220002 |An external identifier used in an external ecommerce platform. This is used to associate the product between TikTok Shop and the external ecommerce platform. Max length: 999 characters | inventory_mode |string |N |SHARED |Defines the inventory mode for the duplicated source product. This parameter supports two modes: SHARED and EXCLUSIVE.
• SHARED: In this mode, the inventory of all interconnected (shared) products must be strictly consistent; otherwise, an error will be returned.
• EXCLUSIVE: In this mode, the inventory for each product can be set independently without affecting others.

Applicability: This feature is applicable ONLY for the EU market. Default Value: If left empty, the system defaults to the EXCLUSIVE mode. | is_cod_allowed |bool |N |false |A flag indicating whether to show the Cash On Delivery (COD) payment option during checkout. Use the Get Category Rules API to check if COD is supported for your product category. Applicable only for the following markets:

• Global sellers: MY, PH, SA, TH, VN
• Local sellers: ID, MY, PH, SA, TH, VN

Note: If COD is not supported, the listing will fail if you set this to true. | key_product_features |[]string |N |["Breathable mesh upper", "Cushioned foam midsole"] |Key Product Features. They will be displayed in the Product highlight module on the product detail page and will be used by search engines to increase your search weight for more traffic. The total number of items should not exceed 5, and the total character count should not exceed 1500. | listing_platforms |[]string |N |["TIKTOK_SHOP"] |The platforms for listing the product. Possible values:

• TOKOPEDIA
• TIKTOK_SHOP Applicable only for sellers that migrated from Tokopedia.

IMPORTANT: This field controls the product's visibility on the listing platforms.

• If the product is live on both platforms but the request contains only 1 platform, the product will be deactivated and hidden from the omitted platform.
• If the product is live on 1 platform but the request contains a different platform, the product will be deactivated and hidden from the omitted platform.
• If you want to deactivate the product on both platforms, use the Deactivate Product API. | locale |string |N |en-US |The BCP-47 locale codes for displaying category information. Default: The default locale of your shop. Possible values:
• cs-CZ
• de-AT
• de-BE
• de-DE
• el-GR
• en-GB
• en-IE
• en-US
• es-ES
• es-MX
• fr-FR
• fr-BE
• hu-HU
• id-ID
• it-IT
• ja-JP
• ms-MY
• nl-NL
• nl-BE
• pl-PL
• pt-BR
• pt-PT
• th-TH
• vi-VN
• zh-CN | main_images |[]object |N | |A list of images to display in the product image gallery.
• Max count: 9
• Arrange your image URIs in the sequence that they should appear on TikTok Shop.
• Image dimensions: [300x300 px, 4000x4000 px]

Recommendations:

• Use a minimum of 5 images.
• The first image should have a white background. Use the Optimize Images API to change the background to white. | ^uri |string |Y |tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe |The URI of the image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=MAIN_IMAGE. You can use the returned URI directly, or process it through the Optimize Images API first and use the resulting URI. | manufacturer_ids |[]string |N |["172959296971220002"] |A comma-delimited list of manufacturer IDs. Retrieve the IDs from the Search Manufacturers API.

Note: Applicable only for the EU market in certain categories. Use the Get Category Rules API to check the requirements. | package_dimensions |object |N | |The dimensions of the product package. Note:

• Provide the dimensions measured after packing the product.
• These values impact the shipping cost, so it is important to ensure that dimensions are accurate. Any discrepancies in measurements may lead to additional shipping fees.
• Optional for ID, TH, VN regions. | ^height |string |Y |12 |The package height. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | ^length |string |Y |10 |The package length. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | ^unit |string |Y |CENTIMETER |The unit for the package dimensions. Possible values based on region:
• US: CENTIMETER, INCH
• Other regions: CENTIMETER

Note: You must use the same system of measurement (metric system or imperial system) for package_weight and package_dimensions. In other words, if you are using KILOGRAM for the weight, you must use CENTIMETER for the dimensions. | ^width |string |Y |11 |The package width. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | package_weight |object |N | |The weight of the product package. Note:

• Provide the weight measured after packing the product.
• This value impacts the shipping cost, so it is important to ensure that dimensions are accurate. Any discrepancies in measurements may lead to additional shipping fees.
• The package weight will take precedence over package dimensions in fee calculation if the fee based on weight is higher. | ^unit |string |Y |KILOGRAM |The unit for the package weight. Possible values based on region:
• US: KILOGRAM, POUND
• BR, JP, MX: KILOGRAM, GRAM
• Other countries: KILOGRAM

Note: You must use the same system of measurement (metric system or imperial system) for package_weight and package_dimensions. In other words, if you are using KILOGRAM for the weight, you must use CENTIMETER for the dimensions. | ^value |string |Y |1.32 |The package weight, which must be a positive number. The number format varies based on the unit:

• GRAM: integer
• KILOGRAM: up to 3 decimal places
• POUND: up to 2 decimal places | pod_info |object |N | |POD customization configuration for an MTO product. Use this object to configure consumer-customizable templates, surfaces, and customization areas for Print-On-Demand products. | ^pod_templates |[]object |N | |A list of POD customization templates. Each template represents one customization plan and can be associated with one or more SKUs. | ^^pod_template_id |string |N |172959296971220002 |The unique identifier of the POD customization template. This field is generated by the system and is not required when creating a new template. | ^^remark |string |N |Front side customization template for basic tee |Optional notes or instructions for this customization template. These notes may be used to remind consumers about customization requirements on the customization page. | ^^sku_ids |[]string |N |["172959296971220002"] |A list of product SKU IDs associated with this customization template. The same SKU cannot be associated with more than one template. | ^^surfaces |[]object |N | |A list of customizable product surfaces under this template, such as the front side, back side, collar, or sleeve. A template can contain up to 10 surfaces. | ^^^background_image |object |N | |The background image of the customizable surface. It is usually the base product image on which customization areas are configured. | ^^^^uri |string |N |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the background image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=CUSTOMIZATION_IM AGE. | ^^^custom_areas |[]object |N | |A list of customizable areas on this surface. The order of the elements represents the layer order to be used when rendering the final customization preview. A surface can contain up to 10 customization areas. | ^^^^area_name |string |N |Front Text Area |The name of the customizable area. | ^^^^area_placement |object |N | |The position, size, and rotation information of the customizable area on the surface. | ^^^^^height |string |N |600 |The height of the customizable area. Supports two decimal places. | ^^^^^rotate_degree |string |N |0 |The rotation angle of the customizable area, in degrees. Supports two decimal places. | ^^^^^width |string |N |600 |The width of the customizable area. Supports two decimal places. | ^^^^^x_coordinate |string |N |0 |The X-coordinate of the customizable area's starting point on the surface. Supports two decimal places. | ^^^^^y_coordinate |string |N |0 |The Y-coordinate of the customizable area's starting point on the surface. Supports two decimal places. | ^^^^area_type |string |N |TEXT |The type of the customizable area. Enum values: TEXT, IMAGE. | ^^^^external_area_id |string |N |172959296971220002 |The seller-defined external identifier of the customizable area, used for mapping with the seller's own system. | ^^^^image_area |object |N | |Configuration for an image-type customization area. This field should be provided when area_type is IMAGE. | ^^^^^default_image |object |N | |Optional default image displayed in this area. If the consumer does not upload a custom image, the default image may be used. | ^^^^^^uri |string |N |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the default image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=CUSTOMIZATION_IM AGE. | ^^^^^min_height |int |N |300 |The minimum required height, in pixels, for an image uploaded by the consumer. | ^^^^^min_width |int |N |300 |The minimum required width, in pixels, for an image uploaded by the consumer. | ^^^^is_required |bool |N |false |Specifies whether the consumer must provide customization content for this area. If set to false, the default content or base product version may be used. | ^^^^text_area |object |N | |Configuration for a text-type customization area. This field should be provided when area_type is TEXT. | ^^^^^align_type |string |N |CENTER |The text alignment type. Enum values: LEFT, CENTER, RIGHT. | ^^^^^colors |[]string |N |["#FFFFFF"] |A list of text colors available for consumers to choose from, using hexadecimal color values such as #FFFFFF. | ^^^^^default_text |string |N |Hello World |Optional default text displayed in this area. If the consumer does not customize this area, the default text may be used. | ^^^^^fonts |[]string |N |["Roboto"] |A list of font keys available for consumers to choose from, based on the platform-supported font library. | ^^^^^max_text_length |int |N |20 |The maximum number of characters allowed for consumer text input. | ^^^external_surface_id |string |N |172959296971220002 |The seller-defined external identifier of the customizable surface, used for mapping with the seller's own system. | ^^^mask_image |object |N | |An optional mask image placed above the customization areas to support irregular or cut-out effects. | ^^^^uri |string |N |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the mask image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=CUSTOMIZATION_IM AGE. | ^^^surface_name |string |N |Front Side |The name of the customizable surface, for example, Front Side or Back Side. | ^^template_name |string |N |T-Shirt Front Print |The name of the customization template, used by the seller for internal management. | product_attributes |[]object |N | |A list of general attributes (e.g. manufacturer, country of origin, materials used) that describe the product as a whole, regardless of variant.

Important: The attributes available for use are determined by the system based on the product's assigned category, with some being mandatory. You must provide the product attributes marked as is_required in the response of the Get Attributes API to avoid listing failure. | ^id |string |Y |100392 |The ID of the product attribute, retrieved from the Get Attributes API. | ^values |[]object |Y | |A list of selectable values for the product attribute. Note: Provide either a built-in ID or a custom name; if both are provided, the ID takes priority. | ^^id |string |N |1001533 |The ID of the product attribute value. This is either a built-in product attribute value ID from Get Attributes API or a custom product attribute value ID returned after calling Create Product API. | ^^name |string |N |Birthday |A self-defined custom product attribute value if the existing values do not satisfy your needs. The system will auto-generate an ID after editing. Note:

• No duplicates allowed under the same attribute.
• Max length: 2000 characters. | replicated_products |[]object |N | |The list of local market replicas to which updates should be synced. As this is a partial edit endpoint, only updated fields will be synced. Compulsory sync
• Sales attribute changes (in sales attribute id/name) must be synced to other markets. Therefore, you must provide the seller_sku above and complete the details in this object. The API call will fail if you don't provide these details. Optional sync
• *New SKUs (new sales attribute value id/name) are optional to sync to other markets. To sync, please provide the seller_sku above and complete the details in this object.
• General changes are optional to sync to other markets. To sync, you only need to provide replicated_products.region. | ^inventory_mode |string |N |SHARED |Defines the inventory mode for the duplicated target product. This parameter supports two modes: SHARED and EXCLUSIVE.
• SHARED: In this mode, the inventory of all interconnected (shared) products must be strictly consistent; otherwise, an error will be returned.
• EXCLUSIVE: In this mode, the inventory for each product can be set independently without affecting others.

Applicability: This feature is applicable ONLY for the EU market. Default Value: If left empty, the system defaults to the EXCLUSIVE mode. | ^region |string |Y |US |The market where you want to publish the global product.Possible values:

• AT: Austria
• BE:Belgium
• CZ:Czech Republic
• DE: Germany
• ES: Spain
• FR: France
• GB: United Kingdom
• GR: Greece
• HU:Hungary
• ID: Indonesia
• IE: Ireland
• IT: Italy
• JP: Japan
• MY: Malaysia
• NL: Netherlands(NL)
• PH: Philippines
• PO: Poland
• PT:Portugal
• SG: Singapore
• TH: Thailand
• US: United States
• VN: Vietnam
• MX: Mexico | ^skus |[]object |N | |The SKUs to be synced to the specified market. Specify this only if you are adding SKUs or changing the sales attribute id/name. Note:
• You must pass in all existing SKUs. Any existing SKU IDs not listed here will result in the deletion of those SKUs. For example, if this product contains 5 SKUs and you only provide 2 SKU IDs, the remaining 3 will be deleted.
• To create new SKUs, leave the SKU ID blank and provide the seller_sku. | ^^external_sku_id |string |N |1729592969712207012 |An external identifier used in an external ecommerce platform. This is used to associate the SKU between TikTok Shop and the external ecommerce platform. Max length: 999 characters | ^^id |string |N |1729592969712207000 |The SKU ID generated by TikTok Shop. Provide this for existing SKUs | ^^inventory |[]object |N | |SKU inventory information per warehouse. This field is mandatory for other regions. But when syncing products from the US to MX, the MX product inventory field is optional. | ^^^quantity |int |N |999 |The SKU quantity available in the warehouse. Valid range: [1, 999,999]. This field is mandatory for other regions. But when syncing products from the US to MX, the MX product inventory field is optional. | ^^^warehouse_id |string |N |7068517275539719942 |The warehouse ID. Retrieve this value from the Get Warehouse List API or Get Inventory Rules API. This field is mandatory for other regions. But when syncing products from the US to MX, the MX product inventory field is optional. | ^^price |object |Y | |The SKU's local display price shown on the product page before any discounts | ^^^currency |string |Y |USD |The currency. Possible values based on the region:
• BRL: Brazil
• CZK: Czech Republic
• EUR: France, Germany, Ireland, Italy, Spain, Netherlands, Belgium, Austria, Greece, Portugal
• GBP: United Kingdom
• HUF: Hungary
• IDR: Indonesia
• JPY: Japan
• MXN: Mexico
• MYR: Malaysia
• PHP: Philippines
• PLN: Poland
• SGD: Singapore
• THB: Thailand
• USD: United States
• VND: Vietnam | ^^^sale_price |string |Y |1.21 |The SKU's local display price shown on the product page before any discounts. Refer to Product Pricing for the allowed price ranges in each market. | ^^seller_sku |string |N |Color-Red-XM001 |The seller_sku value of the source product above.
• Valid length: 1-50 characters
• Format: Text without spaces | responsible_person_ids |[]string |N |["172959296971220003"] |A comma-delimited list of responsible person IDs. Retrieve the IDs from the Search Responsible Persons API.

Note: Applicable only for the EU market in certain categories. Use the Get Category Rules API to check the requirements. | save_mode |string |N |AS_DRAFT |Indicates how the product should be saved. Possible values:

• AS_DRAFT: Save the product as a draft for future editing.
• LISTING: Immediately list the product in the shop. Default: LISTING

Note:

• Saving as draft is not supported in the following cases:
• The product status is DELETED.
• The product status is PENDING or FREEZE on any listing platform.
• If you are saving a post-live draft with save_mode=AS_DRAFT, inventory and delivery_option_ids fields are not supported and will not be saved. | scheduled_sale |object |N | |Scheduled listing configuration for the product, including whether scheduled listing is enabled and the scheduled listing time. | ^is_enabled_scheduled_sale |bool |Y |false |Whether scheduled listing is enabled for this product. If true, scheduled_sale_time must be provided. | ^schedule_sale_time |int |Y |1768899145000 |Scheduled listing time, expressed as a Unix timestamp in milliseconds; must be later than the current time and within 90 days, and is required when is_enabled_scheduled_sale is true. | search_terms |[]string |N |["sneakers","running shoes","athletic"] |Search terms (ST words). ST words will not be displayed to consumers; they are only used in search engines to increase your search weight and gain more traffic. Please ensure that ST words are consistent with the product description, with a maximum of 15 terms and a total of no more than 250 characters. | size_chart |object |N | |The measurement details of the product to help buyers find the right size.

Note:

• For certain product categories, size charts may be required or not supported. Use the Get Category Rules API to check the requirements.
• If size charts are not supported, even if you provide a size chart here, the size chart will not be saved.
• Provide either a TikTok Shop size chart template ID or a size chart image; if both are provided, the ID takes priority. | ^image |object |N | |An image of the size chart.

Recommendations:

• Resolution: Minimum 1024px on the shorter side
• Content: Include key measurement dimensions (e.g., bust, waist, hips, inseam), the more the better.
• Format: Use a table with distinct columns and row.
• Use only one table per product and image.
• Display each dimension in a separate row.
• Display units in column headers. | ^^uri |string |Y |tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe |The URI of the size chart image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=SIZE_CHART_IMAGE. | ^template |object |N | |A TikTok Shop size chart template generated by the size chart tool in Seller Center > Manage Products > Bulk action > Batch manage size charts. | ^^id |string |Y |7267563252536723205 |The size chart template ID. | skus |[]object |N | |A list of Stock Keeping Units (SKUs) used to identify distinct variants of the product.

Note:

• Max SKUs for BR, EU, JP, MX, UK, US: 300
• Max SKUs for other regions: 100

Recommendations: Place the most important variant at the beginning of the array. | ^external_list_prices |[]object |N | |The SKU list price (e.g. MSRP, RRP) or original price information on external ecommerce platforms. Applicable only for selected sellers in the US market. Note: This value may appear as the strikethrough price on the product page. However, whether the strikethrough price is shown and the amount shown are subject to the audit team's review and decision based on various pricing information. | ^^amount |string |Y |1 |The price amount. Valid range: [0.01, 7600] | ^^currency |string |Y |USD |The currency. Possible values: USD | ^^source |string |Y |SHOPIFY_COMPARE_AT_PRICE |The external ecommerce platform from which the price is sourced. Possible values:

• SHOPIFY_COMPARE_AT_PRICE: The compare_at_price in Shopify. | ^external_sku_id |string |N |1729592969712207012 |An external identifier used in an external ecommerce platform. This is used to associate the SKU between TikTok Shop and the external ecommerce platform. Max length: 999 characters | ^external_urls |[]string |N |["https://example.com/path1", "https://example.com/path2"] |A comma-delimited list of URLs for third-party product listing pages where consumers can place orders. Add this property if you have products listed on third-party sites other than TikTok Shop and would like to map them. Max string length: 500 | ^extra_identifier_codes |[]string |N |["00012345678905","9780596520687"] |If the SKU belongs to a virtual bundle (containing multiple individual SKUs), you can add up to 10 additional identifier codes here for the SKUs included in the bundle.

Format: GTIN: 14 digits EAN: 8, 13, or 14 digits UPC: 12 digits ISBN: 13 digits, or 9 digits ending in capital X Note:

• Applicable only for the EU market.
• The identifier code must be unique for each SKU, with no repetition allowed. | ^fees |[]object |N | |The fees required for this product based on TikTok Shop policies. Fees are required only for certain product categories, retrieve the requirements from the Get Category Rules API. | ^^additional_attribute |string |N |SINGLE_USE |An optional attribute that provides additional context for the fee. The accepted values may vary by fee type and market.

Possible values for Pfand:

• SINGLE_USE
• REUSABLE
• NOT_APPLICABLE | ^^amount |string |N |1.01 |The fee amount. Valid range:
• PFAND: [0.00 - 6300.00] | ^^type |string |N |PFAND |The type of fee. Possible values: PFAND | ^id |string |N |1729592969712207012 |The SKU ID generated by TikTok Shop. One product can contain multiple SKU IDs.

Note:

• To edit an existing SKU, include its SKU ID.
• Any existing SKU IDs not listed here will result in the deletion of those SKUs. For example, if this product contains 5 SKUs and you only provide 2 SKU IDs, the remaining 3 will be deleted.
• To create new SKUs, leave the SKU ID blank and complete the other fields. | ^identifier_code |object |N | |A regulated identifier code assigned to a product based on international standardized regulations (e.g. GTIN) to ensure the product is universally identifiable across various platforms and systems.

Note: Editable only if the product is in DRAFT state. Otherwise, changes are not allowed. | ^^code |string |N |12345678901234 |The identifier code. Format:

• GTIN: 14 digits
• EAN: 8, 13, or 14 digits
• UPC: 12 digits
• ISBN: 13 digits, or 9 digits ending in capital X
• JAN: 8 or 13 digits Note: The identifier code must be unique for each SKU, with no repetition allowed. | ^^type |string |N |GTIN |The type of identifier code. Possible values:
• GTIN
• EAN
• UPC
• ISBN
• JAN | ^inventory |[]object |N | |SKU inventory information. Note: If you are saving a post-live draft with save_mode=AS_DRAFT, this field is not supported and will not be saved. When using Get Product to retrieve the draft, the values will reflect those in the base version. | ^^backorder_quantity |int |N |888 |The backorder_quantity will automatically be converted to quantity once in-stock inventory is sold out. The fulfillment of this inventory follows the handling_time specified below. Note: Made-to-order (MTO), pre-order, and custom products cannot be backordered, and thus are incompatible with backorder_quantity. | ^^handling_time |int |N |5 |The estimated number of working days needed for a backorder to be shipped. Currently, different warehouses for the same SKU are not allowed to have different handling_time | ^^quantity |int |Y |999 |The total SKU quantity available in the warehouse. Valid range: [1, 99,999]

Note: This quantity specifically refers to the in-stock inventory that can be shipped immediately. | ^^warehouse_id |string |Y |7068517275539719942 |The ID of the warehouse where the SKU is stored. Retrieve the list of warehouses available for your shop from the Get Warehouse List API. | ^list_price |object |N | |The SKU's list price information. This is equivalent to the manufacturer's suggested retail price (MSRP), or the recommended retail price (RRP). Applicable only for the US market. Note: This value may appear as the strikethrough price on the product page. However, whether the strikethrough price is shown and the amount shown are subject to the audit team's review and decision based on various pricing information. | ^^amount |string |Y |1 |The price amount. Valid range: [0.01, 7600] Note:

• The value must be equal to or greater than skus.price.amount. Otherwise, it will be discarded.
• If the value is verified to be legitimate by the audit team, it will be stored and returned in the Get Product API. | ^^currency |string |Y |USD |The currency. Possible values: USD | ^pre_sale |object |N | |SKU presale information, used to tag a product as a presale product based on its presale type. Applicable only if allowed_special_product_types from Get Category Rules is not empty.

Rules for the US market:

• Regular / Preorder product: Once the product goes live, you cannot change the product type.
• Made-to-order product: You can change it to a regular product at any time. | ^^fulfillment_type |object |N | |Information about the type of pre-sale order fulfillment and the corresponding timeframe.
• handling_duration_days is for fulfillment with an extended duration.
• release_date is for starting fulfillment on a fixed date.

Note: Provide either the handling_duration_days or the release_date, depending on the value of pre_sale.type and your shop's region. | ^^^handling_duration_days |int |N |7 |The desired duration for handling a pre-sale order and handing it over to a shipping carrier. Applicable only for the following regions and pre-sale type: US

• MADE_TO_ORDER: Business days, from 3 to 14 days.
• CUSTOM: Business days, from 3 to 30 days.

UK, EU, SEA, JP, and LATAM

• PRE_ORDER: Calendar days, from 3 to 30 days. | ^^^release_date |int |N |1619611761 |The date on which the product gets converted into a regular product and becomes available for general purchase. On this date, order handling will also start, changing the status of the order to AWAITING_SHIPMENT.

Applicable only for PRE_ORDER in the US. Note:

• Valid range: The date must fall within 3 - 60 days from the current date.
• This date is a unix timestamp (seconds) based on the seller-selected timezone in Seller Center.
• This date cannot be modified once the product goes live. | ^^type |string |N |PRE_ORDER |The type of pre-sale. Possible values based on the region: US
• PRE_ORDER: The product is not yet available or released. Fulfillment can be extended by specifying a release date.
• MADE_TO_ORDER: The product is produced only after the order is received. Fulfillment can be extended by specifying a duration.
• CUSTOM: The product requires a fulfillment timeline that exceeds the standard due to other factors. Fulfillment can be extended by specifying a duration.

UK, EU, SEA, JP, and LATAM

• PRE_ORDER: The product is not yet available or released. Fulfillment can be extended by specifying a duration. | ^price |object |N | |SKU pricing information. | ^^amount |string |N |100.00 |Local sellers/Intra-EU sellers The SKU's local display price shown on the product page before any discounts. Refer to Product Pricing for the allowed price ranges in each market. | ^^currency |string |Y |USD |The currency. Possible values based on the region:
• BRL: Brazil
• CZK: Czech Republic
• EUR: France, Germany, Ireland, Italy, Spain, Netherlands, Belgium, Austria, Greece, Portugal
• GBP: United Kingdom
• HUF: Hungary
• IDR: Indonesia
• JPY: Japan
• MXN: Mexico
• MYR: Malaysia
• PHP: Philippines
• PLN: Poland
• SGD: Singapore
• THB: Thailand
• USD: United States
• VND: Vietnam | ^^sale_price |string |N |1.21 |Global sellers The SKU's local display price shown on the product page before any discounts. Refer to Product Pricing for the allowed price ranges in each market.

Note:

• Applicable for all global sellers.
• Required for JP and US shops using China warehouses. Optional for others.
• This is the definitive final price shown on the product page, all other prices will be ignored. | ^sales_attributes |[]object |N | |A list of attributes (e.g. size, color, length) that define each variant of a product.

Note:

• You must retain at least 1 sales attribute, deleting all existing sales attributes is not allowed.
• You can only have up to 3 types of sales attributes per product.
• Each SKU must include the same number and type of sales attributes. For example, you cannot have one SKU that has only a Color attribute, while another SKU has both Color and Size attributes.
• Provide either a built-in ID or a custom name; if both are provided, the ID takes priority.
• The id/name and value_id/value_name pairs must be unique in each SKU. For example, you cannot repeat "name": "Color", "value_name": "Red" in different SKUs. | ^^id |string |N |100089 |The ID of the sales attribute. This is either a built-in sales attribute ID from Get Attributes API or a custom attribute ID returned after calling Create Product API. | ^^name |string |N |Specification |A self-defined custom sales attribute name if the existing attributes do not satisfy your needs. The system will auto-generate an ID after editing.

Note:

• Do not include sensitive characters.
• Max length: 20 characters | ^^sku_img |object |N | |The default/main image for each value (e.g. red) of the primary sales attribute (e.g. color). This appears in the product options gallery on TikTok Shop.

You can attach images to only 1 type of sales attribute, which will serve as the primary attribute for display. An image must be provided for each value of the primary attribute. For example, if a product has 2 colors and 3 sizes, you can choose to attach images for either the color sales attribute or the size sales attribute. If you choose to attach images for color, you must attach 2 images, one for each color. If you want to add more images, use supplementary_sku_images. | ^^^uri |string |Y |tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe |The URI of the image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=ATTRIBUTE_IMAGE. | ^^supplementary_sku_images |[]object |N | |A list of supplementary images for each value (e.g. red) of the primary sales attribute (e.g. color) to provide multiple views or details of the product for that attribute value. These appear in the product options gallery on TikTok Shop. Note:

• Max number of image URIs: 8.
• Arrange your image URIs in the sequence that they should appear on TikTok Shop.
• Applicable only for the US market. | ^^^uri |string |Y |tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe |The URI of the image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=ATTRIBUTE_IMAGE. | ^^value_id |string |N |1729592969712207000 |The ID of the sales attribute value. This is either a built-in sales attribute value ID from Get Attributes API or a custom sales attribute value ID returned after calling Create Product API. | ^^value_name |string |N |XL |A self-defined custom sales attribute value if the existing values do not satisfy your needs. The system will auto-generate an ID after editing.

Note:

• No duplicates allowed under the same attribute.
• Max length: 50 characters. | ^seller_sku |string |N |seller sku xxaa |An internal code/name for managing SKUs, not visible to buyers.
• Valid length: 1-50 characters
• Format: Text without spaces | ^sku_dimensions |object |N | |The dimensions of the sku.

Note:

• Provide the dimensions measured after packing the product.
• These values impact the shipping cost, so it is important to ensure that dimensions are accurate. Any discrepancies in measurements may lead to additional shipping fees.
• Optional for ID, TH, VN regions. | ^^height |string |Y |10 |The package height. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | ^^length |string |Y |10 |The package length. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | ^^unit |string |Y |CENTIMETER |The unit for the package dimensions. Possible values based on region:
• US: CENTIMETER, INCH
• Other regions: CENTIMETER

Note: You must use the same system of measurement (metric system or imperial system) for package_weight and package_dimensions. In other words, if you are using KILOGRAM for the weight, you must use CENTIMETER for the dimensions. | ^^width |string |Y |10 |The package width. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | ^sku_unit_count |string |N |100.00 |The total quantity/volume of the product represented by the SKU. For example, if the SKU represents 500ml of water, this value would be 500 if the unit type is defined as ml. Valid range: [0.01, 99,999.9999] Applicable only for the EU market. Note:

• This is mainly used to calculate the unit price of the SKU, and is required only if you wish to display the unit price to facilitate easier price comparisons across different products and packaging sizes.
• Unit price = Selling price/(SKU unit count/base unit count). Therefore if you want to obtain the unit price, you would also need to define the "base unit count" and the "unit type" product attributes. Retrieve the relevant information for these product attributes by using the Get Attributes API. The unit price would then be returned in the Get Product API. | ^sku_weight |object |N | |The weight of the sku

Note:

• All the products package weight is mandatory by default, except for products under Virtual Products categories.
• Provide the weight measured after packing the product.
• This value impacts the shipping cost, so it is important to ensure that dimensions are accurate. Any discrepancies in measurements may lead to additional shipping fees.
• The package weight will take precedence over package dimensions in fee calculation if the fee based on weight is higher. | ^^unit |string |Y |KILOGRAM |The unit for the package weight. Possible values based on region:
• US: KILOGRAM, POUND
• BR, JP, MX: KILOGRAM, GRAM
• Other countries: KILOGRAM

Note: You must use the same system of measurement (metric system or imperial system) for package_weight and package_dimensions. In other words, if you are using KILOGRAM for the weight, you must use CENTIMETER for the dimensions. | ^^value |string |Y |1.32 |The package weight, which must be a positive number. The number format varies based on the unit:

• GRAM: integer
• KILOGRAM: up to 3 decimal places
• POUND: up to 2 decimal places | subscribe_info_edit |object |N | |All of the Save and Subscribe discount details. | ^discount_details |[]object |N | |All of the Save and Subscribe discount details. | ^^discount_level |string |N |REGULAR |An enum that communicated the type of discount:
• REGULAR
• FIRST_ORDER
• RETENTION | ^^discount_value |int |N |10 |The value of the discount. A value of 10, would indicate a 10% discount | ^subscribe_status |string |N |ENABLED |An enum outlining whether the given product has an active Subscribe and Save promotion:
• ENABLED
• NOT_ENABLED

This field is required if the subscription is being created or modified. | title |string |N |Title-xxaa |The product title. Title length:

• DE, ES, FR, IE, IT, JP, UK, US: [1, 255]
• BR, MX: [1, 300]
• Other regions: [25, 255] | video |object |N | |A product introduction or promotion video to display for your product.

Recommendations:

• Aspect ratio: 1:1
• Resolution: HD 720p or higher
• Duration: 20 - 60 seconds | ^id |string |Y |v09e40f40000cfu0ovhc77ub7fl97k4w |The ID of the product video. Use the Upload Product File API to upload the video first and obtain the corresponding file ID. |

Query

https://open-api.tiktokglobalshop.com/product/202509/products/1729409636071801988/partial_edit?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY

Body

{"auto_translate_enabled":false,"brand_id":"7082427311584347905","category_version":"v1","certifications":[{"expiration_date":1741235047,"files":[{"format":"PDF","id":"tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe","name":"Certificate.pdf"}],"id":"7182427311584347905","images":[{"uri":"tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe"}]}],"description":" ","external_product_id":"172959296971220002","inventory_mode":"SHARED","is_cod_allowed":false,"key_product_features":["Breathable mesh upper","Cushioned foam midsole"],"listing_platforms":["TIKTOK_SHOP"],"locale":"en-US","main_images":[{"uri":"tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe"}],"manufacturer_ids":["172959296971220002"],"package_dimensions":{"height":"12","length":"10","unit":"CENTIMETER","width":"11"},"package_weight":{"unit":"KILOGRAM","value":"1.32"},"pod_info":{"pod_templates":[{"pod_template_id":"172959296971220002","remark":"Front side customization template for basic tee","sku_ids":["172959296971220002"],"surfaces":[{"background_image":{"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4"},"custom_areas":[{"area_name":"Front Text Area","area_placement":{"height":"600","rotate_degree":"0","width":"600","x_coordinate":"0","y_coordinate":"0"},"area_type":"TEXT","external_area_id":"172959296971220002","image_area":{"default_image":{"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4"},"min_height":300,"min_width":300},"is_required":false,"text_area":{"align_type":"CENTER","colors":["#FFFFFF"],"default_text":"Hello World","fonts":["Roboto"],"max_text_length":20}}],"external_surface_id":"172959296971220002","mask_image":{"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4"},"surface_name":"Front Side"}],"template_name":"T-Shirt Front Print"}]},"product_attributes":[{"id":"100392","values":[{"id":"1001533","name":"Birthday"}]}],"replicated_products":[{"inventory_mode":"SHARED","region":"US","skus":[{"external_sku_id":"1729592969712207012","id":"1729592969712207000","inventory":[{"quantity":999,"warehouse_id":"7068517275539719942"}],"price":{"currency":"USD","sale_price":"1.21"},"seller_sku":"Color-Red-XM001"}]}],"responsible_person_ids":["172959296971220003"],"save_mode":"AS_DRAFT","scheduled_sale":{"is_enabled_scheduled_sale":false,"schedule_sale_time":1768899145000},"search_terms":["sneakers","running shoes","athletic"],"size_chart":{"image":{"uri":"tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe"},"template":{"id":"7267563252536723205"}},"skus":[{"external_list_prices":[{"amount":"1","currency":"USD","source":"SHOPIFY_COMPARE_AT_PRICE"}],"external_sku_id":"1729592969712207012","external_urls":["https://example.com/path1","https://example.com/path2"],"extra_identifier_codes":["00012345678905","9780596520687"],"fees":[{"additional_attribute":"SINGLE_USE","amount":"1.01","type":"PFAND"}],"id":"1729592969712207012","identifier_code":{"code":"12345678901234","type":"GTIN"},"inventory":[{"backorder_quantity":888,"handling_time":5,"quantity":999,"warehouse_id":"7068517275539719942"}],"list_price":{"amount":"1","currency":"USD"},"pre_sale":{"fulfillment_type":{"handling_duration_days":7,"release_date":1619611761},"type":"PRE_ORDER"},"price":{"amount":"100.00","currency":"USD","sale_price":"1.21"},"sales_attributes":[{"id":"100089","name":"Specification","sku_img":{"uri":"tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe"},"supplementary_sku_images":[{"uri":"tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe"}],"value_id":"1729592969712207000","value_name":"XL"}],"seller_sku":"seller sku xxaa","sku_dimensions":{"height":"10","length":"10","unit":"CENTIMETER","width":"10"},"sku_unit_count":"100.00","sku_weight":{"unit":"KILOGRAM","value":"1.32"}}],"subscribe_info_edit":{"discount_details":[{"discount_level":"REGULAR","discount_value":10}],"subscribe_status":"ENABLED"},"title":"Title-xxaa","video":{"id":"v09e40f40000cfu0ovhc77ub7fl97k4w"}}

• NONE: The product is not applicable for audit because it has not been submitted for listing on this platform, or it is in a draft, frozen, or deactivated state.
• AUDITING: The product is currently being audited.
• APPROVED: If you only edited the price or inventory fields of an approved product, the product remains approved and the edits are immediately published on the platform. | ^product_id |string |1729592969712207008 |The product ID generated by TikTok Shop. | ^skus |[]object | |A list of Stock Keeping Units (SKUs) used to identify distinct variants of the product. | ^^external_sku_id |string |1729592969712207012 |An external identifier used in an external ecommerce platform. This is used to associate the SKU between TikTok Shop and the external ecommerce platform. | ^^fees |[]object | |The fees required for this product based on TikTok Shop policies. Fees are required only for certain product categories, retrieve the requirements from the Get Category Rules API. | ^^^additional_attribute |string |SINGLE_USE |An optional attribute that provides additional context for the fee. The accepted values may vary by fee type and market.

Possible values for Pfand:

• SINGLE_USE
• REUSABLE
• NOT_APPLICABLE | ^^^amount |string |1.01 |The fee amount. Valid range:
• PFAND: [0.00 - 6300.00] | ^^^type |string |PFAND |The type of fee. Possible values: PFAND | ^^id |string |1729592969712207012 |The SKU ID generated by TikTok Shop. One product can contain multiple SKU IDs. | ^^sales_attributes |[]object | |A list of attributes (e.g. size, color, length) that define each variant of a product. | ^^^id |string |100000 |The sales attribute ID. If you included the custom sales attribute name in the request, this is a newly generated ID. | ^^^value_id |string |1729592969712207123 |The sales attribute value ID. If you included the custom sales attribute value name in the request, this is a newly generated ID. | ^^seller_sku |string |seller sku xxaa |An internal code/name for managing SKUs, not visible to buyers. |

{"code":0,"data":{"audit":{"status":"AUDITING"},"product_id":"1729592969712207008","skus":[{"external_sku_id":"1729592969712207012","fees":[{"additional_attribute":"SINGLE_USE","amount":"1.01","type":"PFAND"}],"id":"1729592969712207012","sales_attributes":[{"id":"100000","value_id":"1729592969712207123"}],"seller_sku":"seller sku xxaa"}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code