- Applies to:
/api/v3/product - API Version: V3
- Resource: Product Catalog
- Operations: Create, Fetch, Update, Partial Update, Delete
- Supports: Single-product and bulk operations for retrieval and deletion
A product catalog is a collection of products on which Reviews appear on your website. You can use product catalogs to organize products into catalogs and categories, apply product-specific configurations, and customize product review experiences.
The Product Catalog API allows you to create, retrieve, update, partially update, and delete product records. Product records can contain:
- Source information
- Catalog assignments
- Category assignments
- Product attributes
- Pricing information
- Media attachments
- Workflow properties
- Product lifecycle status
A product consists of several logical components:
Product
├─ id
├─ source
│ ├─ sourceType
│ ├─ sourceProductId
│ ├─ sourceId
│ └─ channelType
├─ catalogIds[]
├─ categoryIds[]
├─ title
├─ description
├─ link
├─ price
├─ specification
├─ subSpecification
├─ attachment
├─ workflow
└─ delistedThe source information identifies where the product originated. Catalog and category mappings determine how the product is organized within Sprinklr. Pricing, specifications, media attachments, and workflow metadata enrich the product record.
Products are identified by a unique product identifier.
| Identifier | Purpose |
|---|---|
id | Internal product identifier |
sourceProductId | Product identifier in the source system |
productId | API query parameter used for retrieval, updates, and deletion |
Source systems can also provide additional identifiers such as SKU, GTIN, MPN, retailer ID, and group ID.
| Operation | Method | Endpoint |
|---|---|---|
| Create a product | POST | /api/v3/product |
| Fetch products | GET | /api/v3/product?productId={productIds} |
| Replace a product | PUT | /api/v3/product?productId={productId} |
| Update product fields | PATCH | /api/v3/product?productId={productId} |
| Delete products | DELETE | /api/v3/product?productId={productIds} |
https://api3.sprinklr.com/{env}/api/v3/productReplace {env} with the environment identifier assigned to your Sprinklr account. The default documented value is prod.
All operations require an access token and API key.
| Header | Value | Purpose |
|---|---|---|
Authorization | Bearer {Access Token} | Authenticates the user |
Key | {API Key} | Authenticates the application |
Accept | application/json | Requests a JSON response |
Content-Type | application/json | Identifies the request body as JSON |
Authorization: Bearer {Access Token}
Key: {API Key}
Accept: application/json
Content-Type: application/jsonThe source documentation does not specify the permissions required to use this API.
Creates a product and associates it with one or more product catalogs. A successful request returns the created product record.
POST https://api3.sprinklr.com/{env}/api/v3/product| Field | Type | Required | Description |
|---|---|---|---|
source | Object | Yes | Source details for the product |
catalogIds | Array of Strings | No | Identifiers of catalogs that contain the product |
categoryIds | Array of Strings | No | Identifiers of categories assigned to the product |
title | String | No | Product title |
description | String | No | Product description |
link | String | No | Product URL |
price | Object | No | Pricing information |
standardPrice | Number | No | Standard product price |
sellingPrice | Number | No | Selling price |
currency | String | No | Currency for the standard or selling price |
availability | String | No | Product availability status |
inventory | Integer | No | Available inventory quantity |
gtin | String | No | Global Trade Item Number |
mpn | String | No | Manufacturer part number |
brand | String | No | Brand name |
retailerId | String | No | Retailer-specific identifier |
sku | String | No | Stock keeping unit |
groupId | String | No | Identifier used to group product variants |
specification | Map of String to String | No | Attributes that distinguish a variant from other products in the same group |
subSpecification | Map of String to Object | No | Additional attributes associated with a specification attribute |
attachment | Object | No | Media attached to the product |
workflow | Object | No | Workflow properties associated with the product |
delisted | Boolean | No | Indicates whether the product is delisted |
| Field | Type | Required | Description |
|---|---|---|---|
sourceType | String | Yes | Type of product source |
sourceProductId | String | Yes | Unique product identifier in the source system |
sourceId | String | No | Identifier of the source account or system |
channelType | String | Yes | Channel associated with the product source |
| Field | Type | Required | Description |
|---|---|---|---|
value | Number | Yes, when price is included | Product price amount |
currency | String | No | Currency associated with the price amount |
| Field | Type | Required | Description |
|---|---|---|---|
type | String | Yes, when attachment is included | Attachment type |
url | String | No | URL of the attached media |
alternateText | String | No | Alternative text for the attachment |
| Field | Type | Required | Description |
|---|---|---|---|
assignment | Object | No | Assignment details associated with the product |
modifiedTime | Integer | No | Workflow modification time in epoch milliseconds |
customProperties | Map of String to Array of Strings | No | Custom properties associated with the product |
queues | Array of Objects | No | Queue information associated with the product workflow |
spaceWorkflows | Array of Objects | No | Workspace-level workflows associated with the product |
curl --location 'https://api3.sprinklr.com/{env}/api/v3/product' \
--header 'Authorization: Bearer {Access Token}' \
--header 'Key: {API Key}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"source": {
"sourceType": "ACCOUNT",
"sourceProductId": "SKU-200897",
"sourceId": "{sourceId}",
"channelType": "SOURCE_AGNOSTIC"
},
"catalogIds": ["{catalogId}"],
"categoryIds": ["FRAGRANCE"],
"title": "Sample Product",
"description": "Sample product description",
"link": "https://example.com/products/sku-200897",
"price": {
"value": 78.00,
"currency": "USD"
},
"groupId": "20097",
"attachment": {
"type": "IMAGE",
"url": "https://example.com/images/product.jpg"
},
"workflow": {
"customProperties": {
"{customFieldId}": ["New"]
}
}
}'A successful request returns 201 Created and the newly created product.
{
"data": {
"id": "6a9968815d82d94f23d44994",
"source": {
"sourceType": "ACCOUNT",
"sourceId": "{sourceId}",
"sourceProductId": "SKU-200897",
"channelType": "SOURCE_AGNOSTIC"
},
"catalogIds": ["{catalogId}"],
"categoryIds": ["FRAGRANCE"],
"title": "Sample Product",
"description": "Sample product description",
"link": "https://example.com/products/sku-200897",
"price": {
"value": 78.0,
"currency": "USD"
},
"groupId": "20097",
"attachment": {
"url": "https://example.com/images/product.jpg",
"encryptedUrl": "enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"type": "IMAGE"
},
"workflow": {
"customProperties": {
"{customFieldId}": ["New"]
}
},
"delisted": false
},
"errors": []
}Replaces an existing product with the product definition supplied in the request body. Include all product attributes that you want to retain.
PUT https://api3.sprinklr.com/{env}/api/v3/product?productId={productId}| Parameter | Type | Required | Description |
|---|---|---|---|
productId | String | Yes | Identifier of the product to update |
curl --location --request PUT \
'https://api3.sprinklr.com/{env}/api/v3/product?productId={productId}' \
--header 'Authorization: Bearer {Access Token}' \
--header 'Key: {API Key}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"source": {
"sourceType": "ACCOUNT",
"sourceProductId": "{sourceProductId}",
"sourceId": "{sourceId}",
"channelType": "SOURCE_AGNOSTIC"
},
"catalogIds": ["{catalogId}"],
"categoryIds": ["{categoryId}"],
"title": "Updated product title",
"description": "Updated product description",
"link": "https://example.com/products/{sourceProductId}",
"price": {
"value": 99.0
},
"specification": {
"{attributeName}": "{attributeValue}"
},
"groupId": "{groupId}",
"attachment": {
"type": "IMAGE",
"url": "https://example.com/images/product.jpg"
},
"workflow": {
"customProperties": {
"{customFieldId}": ["{customFieldValue}"]
}
},
"delisted": false
}'HTTP/1.1 204 No ContentThe response body is empty.
Updates selected fields in an existing product. Fields not included in the request are preserved.
PATCH https://api3.sprinklr.com/{env}/api/v3/product?productId={productId}| Parameter | Type | Required | Description |
|---|---|---|---|
productId | String | Yes | Identifier of the product to update |
| Field | Type | Description |
|---|---|---|
title | String | Product title |
description | String | Product description |
link | String | Product URL |
standardPrice | Number | Standard product price |
sellingPrice | Number | Selling price |
currency | String | Product price currency |
availability | String | Product availability status |
inventory | Integer | Available inventory quantity |
gtin | String | Global Trade Item Number |
mpn | String | Manufacturer part number |
brand | String | Brand name |
retailerId | String | Retailer-specific identifier |
sku | String | Stock keeping unit |
groupId | String | Identifier used to group product variants |
specification | Map of String to String | Attributes that distinguish a product variant |
subSpecification | Map of String to Object | Additional specification attributes |
catalogIds | Array of Strings | Catalog identifiers |
categoryIds | Array of Strings | Category identifiers |
attachment | Object | Product media |
workflow | Object | Product workflow properties |
delisted | Boolean | Indicates whether the product is delisted |
curl --location --request PATCH \
'https://api3.sprinklr.com/{env}/api/v3/product?productId={productId}' \
--header 'Authorization: Bearer {Access Token}' \
--header 'Key: {API Key}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"sellingPrice": 69.99,
"currency": "USD",
"inventory": 8,
"availability": "IN_STOCK"
}'HTTP/1.1 204 No ContentThe response body is empty.
Deletes one or more products. To delete multiple products, supply their identifiers as a comma-separated list.
DELETE https://api3.sprinklr.com/{env}/api/v3/product?productId={productIds}| Parameter | Type | Required | Description |
|---|---|---|---|
productId | String | Yes | One product ID or a comma-separated list of product IDs |
curl --location --request DELETE \
'https://api3.sprinklr.com/{env}/api/v3/product?productId={productId}' \
--header 'Authorization: Bearer {Access Token}' \
--header 'Key: {API Key}' \
--header 'Accept: application/json'curl --location --request DELETE \
'https://api3.sprinklr.com/{env}/api/v3/product?productId={productId1},{productId2}' \
--header 'Authorization: Bearer {Access Token}' \
--header 'Key: {API Key}' \
--header 'Accept: application/json'HTTP/1.1 204 No ContentThe response body is empty.
Retrieves one or more products. Supply one product ID or a comma-separated list of product IDs.
GET https://api3.sprinklr.com/{env}/api/v3/product| Parameter | Type | Required | Description |
|---|---|---|---|
productId | String | Yes | Product identifier or comma-separated list of product identifiers |
curl --location \
'https://api3.sprinklr.com/{env}/api/v3/product?productId={productId}' \
--header 'Authorization: Bearer {Access Token}' \
--header 'Key: {API Key}' \
--header 'Accept: application/json'curl --location \
'https://api3.sprinklr.com/{env}/api/v3/product?productId={productId1},{productId2}' \
--header 'Authorization: Bearer {Access Token}' \
--header 'Key: {API Key}' \
--header 'Accept: application/json'A successful request returns 200 OK and one or more products in the data array.
{
"data": [
{
"id": "{productId}",
"source": {
"sourceType": "ACCOUNT",
"sourceId": "{sourceId}",
"sourceProductId": "{sourceProductId}",
"channelType": "SOURCE_AGNOSTIC"
},
"catalogIds": ["{catalogId}"],
"categoryIds": ["{categoryId}"],
"title": "Sample Product",
"description": "Sample product description",
"link": "https://example.com/products/{sourceProductId}",
"price": {
"value": 78.0,
"currency": "USD"
},
"groupId": "{groupId}",
"attachment": {
"url": "https://example.com/images/product.jpg",
"encryptedUrl": "{encryptedUrl}",
"type": "IMAGE"
},
"workflow": {
"customProperties": {
"{customFieldId}": ["{customFieldValue}"]
}
},
"delisted": false
}
],
"errors": []
}| Field | Type | Description |
|---|---|---|
id | String | Unique identifier of the product |
source | Object | Source details associated with the product |
catalogIds | Array of Strings | Catalog identifiers associated with the product |
categoryIds | Array of Strings | Category identifiers associated with the product |
title | String | Product title |
description | String | Product description |
link | String | Product URL |
price | Object | Product pricing information |
specification | Map of String to String | Product attributes |
groupId | String | Product group identifier |
attachment | Object | Product media |
workflow | Object | Product workflow properties |
delisted | Boolean | Indicates whether the product is delisted |
| Field | Type | Description |
|---|---|---|
url | String | Attachment URL |
encryptedUrl | String | Encrypted attachment URL |
type | String | Attachment type |
Create and Fetch operations return a response envelope containing data and errors.
Create response:
{
"data": {},
"errors": []
}Fetch response:
{
"data": [],
"errors": []
}| Operation | data Type |
|---|---|
| Create | Object |
| Fetch | Array of Objects |
| HTTP Code | Operation | Meaning |
|---|---|---|
200 OK | GET | The requested products were returned |
201 Created | POST | The product was created |
204 No Content | PUT | The product was replaced |
204 No Content | PATCH | The product fields were updated |
204 No Content | DELETE | The products were deleted |
| Value | Evidence |
|---|---|
ACCOUNT | Used in the request and response examples |
EXTERNAL | Listed as an example source type |
| Value | Evidence |
|---|---|
SOURCE_AGNOSTIC | Used in the request and response examples |
| Value |
|---|
IMAGE |
VIDEO |
CAROUSEL |
LINK |
DOC |
| Value | Evidence |
|---|---|
IN_STOCK | Used in the partial-update example |
Additional availability values are not documented in the available source.
- Extract product information from the commerce platform.
- Map source identifiers and catalog assignments.
- Send a POST request to create each product.
- Store the returned product IDs for future operations.
- Retrieve existing products with GET.
- Compare the returned data with the source system.
- Use PUT to replace complete outdated records.
- Use PATCH to change selected fields.
- Delete obsolete products when appropriate.
Use PATCH when only operational fields change.
{
"sellingPrice": 69.99,
"currency": "USD",
"inventory": 8,
"availability": "IN_STOCK"
}Use:
groupIdto associate related variants.specificationto distinguish products in the same variant group.subSpecificationto store additional attributes associated with a specification.
- Use PUT to replace the complete product definition.
- Use PATCH to update selected fields while preserving omitted fields.
Include every field that you want to retain. PUT replaces the existing product with the submitted payload.
Treat specification, subSpecification, and workflow.customProperties as dynamic map structures. Do not assume fixed property names.
GET and DELETE accept comma-separated product IDs. Use bulk operations to reduce API calls when appropriate.
Attachment responses can include both url and encryptedUrl. Support both fields in your response model.
Use placeholders in examples and store access tokens and API keys securely. Do not commit credentials to source control or application logs.