Products

Product updates

POST https://your.store.com/cottoncast/product

Each time you create or edit a product in PODrocket we will make a request to this webhook. You can configure the URL in your sales channel settings.

Query Parameters

Name	Type	Description
recipe	string	The API will do its best to find a cake matching the provided recipe.
gluten	boolean	Whether the cake should be gluten-free or not.

202 Product successfully received for processing.

{
    "status": "ok"
}

404 Could not find a cake matching this query.

{
    "status": "error",
    "message": "Page not found"
}

Your webhook should respond with code 202: Accepted. Processing of the product data must be done asynchronously.

Example request body

{
  "name": "BigBrand T-shirt Black",
  "description": "Lorem ipsum",
  "status": {
    "code": "P",
    "description": "Published"
  },
  "sku": "34RX",
  "brand": "BigBrand",
  "category": {
    "code": "S",
    "description": "T-Shirt"
  },
  "agegroups": [
    {
      "code": "M",
      "description": "Men"
    }
  ],
  "price": 29.95,
  "config": {
    "type": "predesign",
    "code": "color-size",
    "labels": [
      {
        "code": "color",
        "label": "Color"
      },
      {
        "code": "size",
        "label": "Size"
      }
    ]
  },
  "variants": [
    {
      "sku": "34RX-BLA-S",
      "hexcolor": "#dedede",
      "status": {
        "code": "A",
        "name": "Active"
      },
      "config": {
        "options": [
          {
            "code": "color",
            "type": "color",
            "value": "BLA",
            "label": "Black"
          },
          {
            "code": "size",
            "type": "size",
            "value": "S",
            "label": "S"
          }
        ]
      },
      "images": [
        {
          "code": "F",
          "description": "Front",
          "url": "https://texo.cottoncast.com/EFG763.png"
        }
      ]
    }
  ],
  "images": [
    {
      "code": "F",
      "description": "Front",
      "url": "https://texo.cottoncast.com/EFG763.png"
    }
  ],
  "tags": [
    "men",
    "hello",
    "world"
  ],
  "meta": {
    "saleschannelID": "5d963a94b9e99e4ce0468ff2",
    "language": "en"
  }
}