Mircate
  1. Talking Product
Mircate
  • Introduction
  • Authentication
  • Errors
  • Change Logs
  • PIM
    • Get Products
      POST
    • Get Product Settings
      GET
    • Get Catalog Settings
      GET
    • Upsert Product
      POST
    • Upsert Category
      POST
    • Bulk Product Upsert
      POST
    • Check Batch Status
      POST
    • Delete Product
      POST
    • Attach Product Attribute Image
      POST
    • Attach Category Image
      POST
    • Get Image
      GET
    • Upsert Attributes
      POST
    • Delete Attribute
      POST
    • Upsert Attribute Options
      POST
    • Upsert Attribute Option
      POST
    • Delete Attribute Option
      POST
  • Promotion
    • Calculate
      POST
    • Start Transaction
      POST
    • Commit Transaction
      POST
    • Revert Transaction
      POST
    • Cancel Transaction
      POST
    • Get Active Promotions
      GET
  • Loyalty
    • Receive Event
    • Calculate
    • Start Transaction
    • Commit Transaction
    • Cancel Transaction
    • List Measurements
  • Wallet
    • Get Wallet
    • Create Wallet
    • Create Account
    • Get Account
    • Get Accounts
    • List Accounts
    • List Transactions
    • Add Account
    • Remove Account
    • Fix
    • Load
    • Spend
    • Refund
    • Cancel
  • Talking Product
    • Create Product
      POST
    • Update Product
      POST
    • Delete Product
      POST
    • Get Product
      GET
    • List Product
      POST
  • Merchant
    • Sales Channel
      • Reserve Stock
      • Cancel Stock
      • Commit Stock
      • Refund Stock
      • Get Current Stock
    • Product Supplier
      • Receive Stock
      • Receive Price
      • Get Stock/Price History
      • Check Batch Status
      • Remove My Products
      • Clean My Products
      • Export Stock/Price
      • List Exports
      • Get Exported Files
    • Global Products
      • Receive Products
      • Get Global Products
      • Remove Global Products
  • Common
    • Dataset
      • Create
      • Update
      • Delete
      • Value Upsert
      • Value Delete
      • List Sources
      • List Values
  • How to
    • Creating a Promotion Template
    • Promotion Transaction Flow
    • Understanding PIM Product Statuses
  1. Talking Product

Create Product

Production
https://api.b2b.retter.io/5p1hp1d2t
Production
https://api.b2b.retter.io/5p1hp1d2t
POST
https://api.b2b.retter.io/5p1hp1d2t
/{{STAGE_PROJECT_ID}}/CALL/TalkingProducts/createProduct/{{MIRCATE_PROJECT_ID}}
Last modified:24 days ago
This endpoint is used to create a new product in the Talking Products module. It accepts product details such as name, SKU, brand, image, stock, and additional metadata. Once created, the product becomes available for listing and use in AI-driven product interactions.

Request

Authorization
Add parameter in header
x-api-key
Example:
x-api-key: ********************
Header Params
x-api-key
string 
required
Example:
{{API_KEY}}
Body Params application/json
product
object 
required
sku
string 
required
name
string 
required
categories
array[string]
required
brand
string 
required
description
string 
required
stock
integer 
required
price
integer 
required
image
string 
required
groupIds
array[string]
required
openaiId
string 
required
additionalData
object 
required
Example
{
    "product": {
        "sku": "sku123Rose9",
        "name": "Rosé Pink",
        "categories": [],
        "brand": "drap2dasdpier",
        "description": "",
        "stock": 8,
        "price": 50000,
        "image": "https://b2btest.c.retter.io/project/328j1q9mo/Classes/TalkingProducts/instance/27z7tk4s3pf.jpg",
        "groupIds": [],
        "openaiId": "file-GjLCbUiHmB9NrE56ZFqW8b",
        "additionalData": {
            "field": "high stiffness",
            "field2": "spicy"
        }
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
curl --location -g --request POST 'https://api.b2b.retter.io/5p1hp1d2t/{{STAGE_PROJECT_ID}}/CALL/TalkingProducts/createProduct/{{MIRCATE_PROJECT_ID}}' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
    "product": {
        "sku": "sku123Rose9",
        "name": "Rosé Pink",
        "categories": [],
        "brand": "drap2dasdpier",
        "description": "",
        "stock": 8,
        "price": 50000,
        "image": "https://b2btest.c.retter.io/project/328j1q9mo/Classes/TalkingProducts/instance/27z7tk4s3pf.jpg",
        "groupIds": [],
        "openaiId": "file-GjLCbUiHmB9NrE56ZFqW8b",
        "additionalData": {
            "field": "high stiffness",
            "field2": "spicy"
        }
    }
}'

Responses

🟢200Success
application/json
Body
object {0}
Example
{}
Modified at 24 days ago
Previous
Cancel
Next
Update Product
Built with