Skip to main content

Create a product

Create a new product in Propeller from an external system like a PIM, mapping external fields to Propeller's product model.

Endpoint​

POST /products/

Request​

{
  "names": [
    { "language": "EN", "value": "Wireless Bluetooth Headset Pro" },
    { "language": "NL", "value": "Draadloze Bluetooth Headset Pro" }
  ],
  "language": "EN",
  "sku": "WBH-PRO-500",
  "status": "A",
  "descriptions": [
    { "language": "EN", "value": "<p>Professional wireless headset with noise cancellation and 24-hour battery life.</p>" },
    { "language": "NL", "value": "<p>Professionele draadloze headset met ruisonderdrukking en 24 uur batterijduur.</p>" }
  ],
  "shortDescriptions": [
    { "language": "EN", "value": "Wireless headset with ANC" },
    { "language": "NL", "value": "Draadloze headset met ANC" }
  ],
  "manufacturer": "AudioTech",
  "oemCode": "AT-WBH-500",
  "eanCode": "8710000000123",
  "supplier": "TechDistri",
  "supplierCode": "TD-78901",
  "taxCode": "H",
  "unit": 1,
  "minimumQuantity": 1,
  "source": "pim-akeneo",
  "sourceId": "PRD-00482"
}

Response​

{
  "data": {
    "id": 98765,
    "names": [
      { "language": "EN", "value": "Wireless Bluetooth Headset Pro" },
      { "language": "NL", "value": "Draadloze Bluetooth Headset Pro" }
    ],
    "sku": "WBH-PRO-500",
    "status": "A",
    "manufacturer": "AudioTech",
    "oemCode": "AT-WBH-500",
    "eanCode": "8710000000123",
    "supplier": "TechDistri",
    "supplierCode": "TD-78901",
    "source": "pim-akeneo",
    "sourceId": "PRD-00482",
    "createdAt": "2026-02-19T14:30:00.000Z",
    "lastModifiedAt": "2026-02-19T14:30:00.000Z"
  }
}

How it works​

Use POST /products/ to create a new product. Localized fields like names, descriptions and shortDescriptions accept an array of language objects. Set status to A (active) for products ready to sell, or N (new) for products still being enriched. The source and sourceId fields let you tag products with your external system's identifier, making it easy to look them up later without storing Propeller IDs in your PIM.

What this call does not include

Creating a product sets up the product record only. Pricing and inventory are managed through separate endpoints. To make a product orderable, you also need to set up inventory using the inventory endpoints.

See also​