--- title: "Post SKU" slug: "post-sku-2" updated: 2026-06-08T13:08:12Z published: 2026-06-08T13:08:12Z canonical: "pccdocs.bluemeteor.com/post-sku-2" --- > ## Documentation Index > Fetch the complete documentation index at: https://pccdocs.bluemeteor.com/llms.txt > Use this file to discover all available pages before exploring further. # Post SKU Post/amazeApiRest/rest/v1/catalogs/4/skus This API endpoint is used to create or update SKU records along with their associated product data (such as attributes and identifiers). Header parametersX-Access-TokenstringExampleAHiWIfzgk1agkj29iosfL47m1ZEE30lEXbZksjCF7BhZTh1pQz220S70 X-Customer-CodestringExampleAPITST X-Oauth-ProviderstringExampleCODIFYD Content-TypestringExampleapplication/json X-Requested-WithstringExampleXMLHttpRequest x-authorization-modestringExamplepassword X-Client-SecretstringExample6CHewppLoyVJIVwDAkwEG9J1SRySiISh **NOTE**: Use these header/query parameter examples mentioned above to execute this endpoint on the right and retrieve a sample API response. ### ### QUERY PARAMETERS **catalogKey** (catalogId) The unique internal identifier of a catalog in the system. This parameter ensures that all API operations are performed within the correct catalog associated with a specific customer. --- **replaceAttributes**: would typically control how SKU attributes are handled during an update operation: - If **true**: - Existing standard (non-domain) SKU attributes are replaced based on the values provided in the request payload. Attributes not included in the payload are removed. - Existing domain SKU attributes remain unchanged and are not replaced or removed, regardless of the payload contents. - If **false** (or not provided): The API would merge/update only the provided attributes, leaving existing attributes unchanged. Query parameterscatalogKeystring replaceAttributesstring Body parametersobject Example[ { "customerCode": "APITST", "customerSkuId": "SKU-001", "skuTitle": "demo sku", "type": "SKU", "skuAttributes": [ { "attributeName": "ASIN", "customerAttributeId": "75887", "attributeType": "String", "skuAttributeValues": [ { "value": "ABA10010", "uomName": "Ampere", "uomSymbol": "amp" } ], "locked": false }, { "attributeName": "Brand", "customerAttributeId": "49164", "attributeType": "String", "skuAttributeValues": [ { "value": "456" } ], "locked": false } ], "residentTaxonomy": { "taxonomyPath": "Footwear>Men>Shoes>Casuals>Sparx>SM-757", "taxonomyName": "SM-757", "taxonomyCustomerId": "Casual shoes for men - Black", "domainName": "Primary" }, "digitalAssets": [], "domainRelationshipMetaData": [ { "relationshipTableName": "Domain Rel Table 1", "relationshipRows": [ { "relatedDomainRecords": [ { "domain": "Supplier", "domainRecord": "Supplier A" }, { "domain": "State", "domainRecord": "India" } ], "relationshipAttributeValues": [ { "relationshipAttributeName": "Sku-Rel-Attribute-A", "relationshipAttributeValue": "Value-A1", "uomSymbol": "cm" }, { "relationshipAttributeName": "Sku-Rel-Attribute-B", "relationshipAttributeValue": "Value-B1" } ] }, { "relatedDomainRecords": [ { "domain": "Supplier", "domainRecord": "Supplier B" }, { "domain": "State", "domainRecord": "USA" } ], "relationshipAttributeValues": [ { "relationshipAttributeName": "Sku-Rel-Attribute-A", "relationshipAttributeValue": "Value-A2" }, { "relationshipAttributeName": "Sku-Rel-Attribute-B", "relationshipAttributeValue": "Value-B2", "uomSymbol": "mm" } ] } ] } ] } ] ### Request Parameters **amazeKeySkuIdentifier** (integer) Internal identifier of the SKU in PCC. --- **customerSkuId** (string) This is a comma-seperated list of SKU item id used to return specific SKUs only. **Example**: "customerSkuIds": "SKU_1, SKU_2, SKU_3,SKU_4" --- **skuTitle** (string) Title associated with the SKU. --- **type** (string) Describes the type of SKU with possible values SKU/Product Family. --- ### **Taxonomy Details** **residentTaxonomy.taxonomyPath** (string) Path of the taxonomy where the SKU resides. --- **residentTaxonomy.taxonomyCustomerId** (string) Customer ID of the taxonomy where the SKU resides. --- **crosslistedToTaxonomies.taxonomyPath** (string) Path of the taxonomy where the SKU is cross-listed. --- **crosslistedToTaxonomies.taxonomyCustomerId** (string) Customer ID of the taxonomy where the SKU is cross-listed. --- **mirroredToTaxonomies.taxonomyPath** (string) Path of the taxonomy where the SKU is mirrored. --- **mirroredToTaxonomies.taxonomyCustomerId** (string) Customer ID of the taxonomy where the SKU is mirrored. --- **mirroredToTaxonomies.domainName** (string) Name of the domain in which the taxonomy is mirrored. --- ### **SKU Attributes** **skuAttributes.attributeName** (string) Name of the attribute used in the SKU. --- **skuAttributes.skuAttributeValues.value** (string) Value of the attribute associated with the SKU. --- **skuAttributes.customerAttributeId** (string) Customer ID of the attribute used in the SKU. --- **skuAttributes.locked** (string) Indicates whether the attribute is locked for modification. --- **skuAttributes.skuAttributeValues.uomName** (string) Unit of measure name for the attribute value. --- **skuAttributes.skuAttributeValues.uomSymbol** (string) Unit of measure symbol for the attribute value. --- ### **Digital Assets** **digitalAssets.digitalAssetName** (string) Name of the digital asset associated with the SKU. --- **digitalAssets.digitalAssetPublicURL** (string) Public URL to access the digital asset. --- **digitalAssets.digitalAssetThumbnailPublicURL** (string) Public URL for the thumbnail of the digital asset. --- **digitalAssets.isPrimary** (string) Indicates whether the asset is the primary asset. --- **domainRelationshipMetaData** (string) Defines relationships between the SKU and multiple domain records (e.g., Supplier, State), along with additional attributes that describe each relationship. This structure allows you to capture contextual, multi-entity associations and store metadata specific to those relationships. --- **relationshipTableName** (arrray of objects) The name of the relationship table that groups related domain associations. This typically represents a logical relationship type (e.g., supplier-specific relationships). --- **relationshipRows** (array of objects) A collection of relationship entries. Each row represents a single relationship instance between the SKU and a set of domain records, along with its associated attributes. --- **relatedDomainRecords** (array of objects) Specifies the domain entities involved in the relationship. Each object identifies a domain and the corresponding record linked to the SKU. - **domain** (string) The name of the domain (e.g., Supplier, State). - **domainRecord** (string) The specific record within the domain (e.g., Supplier A, India). **Note**: This field is only populated when the corresponding domain has been configured and linked to the SKU. --- **relationshipAttributeValues** (array of objects) Defines attribute values associated with the relationship. These attributes provide additional context or metadata specific to the relationship instance. - **relationshipAttributeName** (string): The name of the relationship attribute. - **relationshipAttributeValue** (string): The value assigned to the relationship attribute. **Note**: This field is only populated when the corresponding relationship attribute values has been defined & linked to the SKU otherwise an error gets displayed. Responses200 Successful response ### Response Parameters **responseSummary.Count of SKUs sent in payload** Total number of SKUs included in the request payload. --- **responseSummary.Count of SKUs successfully loaded into PCC** Number of SKUs that were successfully created or updated in the system. --- **responseSummary.Count of SKUs which errored entirely** Number of SKUs that failed completely during processing. --- **responseSummary.Count of SKUs which errored partially** Number of SKUs that encountered partial errors during processing. --- **responseSummary.Count of SKUs newly added** Number of new SKUs created in the system. --- **responseSummary.Count of SKUs updated or moved** Number of SKUs that were updated or moved. --- **responseSummary.Count of new DAs** Number of digital assets created. --- **responseSummary.Newly added CustomerSkuIds** List of external SKU IDs that were newly created. --- **responseSummary.Updated CustomerSkuIds** List of external SKU IDs that were updated. --- **failedSkuReport.skuKey** Internal identifier of the SKU that failed during processing. --- **failedSkuReport.customerSkuId** External ID of the SKU that failed. --- **failedSkuReport.partialFail** Indicates whether the failure was partial or complete. --- **failedSkuReport.failedRecords.location** Location in the payload where the failure occurred. --- **failedSkuReport.failedRecords.payloadData** The specific data in the payload that caused the failure. --- **failedSkuReport.failedRecords.reason** Reason for the failure of the SKU operation. **NOTE**: Copy the response from the right panel and paste it into any editor (e.g., DOCX or Notepad++) to view the full API response.