Create Product & SKU | Webflow Developer Documentation

from webflow import Webflow, ProductFieldData, SkuPropertyList, SkuPropertyListEnumItem, SkuFieldData, SkuFieldDataPrice
from webflow.products import ProductSkuCreateProduct, ProductSkuCreateSku
client = Webflow(
    access_token="YOUR_TOKEN_HERE",
)
client.products.create(
    site_id="580e63e98c9a982ac9b8b741",
    product=ProductSkuCreateProduct(
        field_data=ProductFieldData(
            name="Colorful T-shirt",
            slug="colorful-t-shirt",
            description="Our best-selling t-shirt available in multiple colors and sizes",
            sku_properties=[
                SkuPropertyList(
                    id="color",
                    name="Color",
                    enum=[
                        SkuPropertyListEnumItem(
                            id="red",
                            name="Red",
                            slug="red",
                        ),
                        SkuPropertyListEnumItem(
                            id="yellow",
                            name="Yellow",
                            slug="yellow",
                        ),
                        SkuPropertyListEnumItem(
                            id="blue",
                            name="Blue",
                            slug="blue",
                        )
                    ],
                ),
                SkuPropertyList(
                    id="size",
                    name="Size",
                    enum=[
                        SkuPropertyListEnumItem(
                            id="small",
                            name="Small",
                            slug="small",
                        ),
                        SkuPropertyListEnumItem(
                            id="medium",
                            name="Medium",
                            slug="medium",
                        ),
                        SkuPropertyListEnumItem(
                            id="large",
                            name="Large",
                            slug="large",
                        )
                    ],
                )
            ],
        ),
    ),
    sku=ProductSkuCreateSku(
        field_data=SkuFieldData(
            name="Colorful T-shirt - Red Small",
            slug="colorful-t-shirt-red-small",
            price=SkuFieldDataPrice(
                value=2499,
                unit="USD",
                currency="USD",
            ),
            main_image="https://rocketamp-sample-store.myshopify.com/cdn/shop/products/Gildan_2000_Antique_Cherry_Red_Front_1024x1024.jpg?v=1527232987",
        ),
    ),
    publish_status="staging",
)

{
  "product": {
    "id": "660eb7a486d1d6e0412292d7",
    "cmsLocaleId": "653ad57de882f528b32e810e",
    "lastPublished": "2024-04-04T14:24:19.467Z",
    "lastUpdated": "2024-04-04T14:30:19.282Z",
    "createdOn": "2024-04-04T14:22:28.547Z",
    "isArchived": false,
    "isDraft": false,
    "fieldData": {
      "name": "T-Shirt",
      "slug": "t-shirt",
      "description": "A plain t-shirt",
      "shippable": true,
      "sku-properties": [
        {
          "id": "31b77fa66fa376c2c0abb458d5be39fb",
          "name": "Size",
          "enum": [
            {
              "id": "8d21a625d655ab260e9941c27180c75b",
              "name": "Small",
              "slug": "small"
            },
            {
              "id": "ecdca17106ad86c0dfe3b5f3ac8be6c9",
              "name": "Medium",
              "slug": "medium"
            },
            {
              "id": "ec7877d6137ecf7ec86f726c135b1812",
              "name": "Large",
              "slug": "large"
            }
          ]
        },
        {
          "id": "74d3738e62c568d5634dd6989daec5ec",
          "name": "Color",
          "enum": [
            {
              "id": "e539b0d6c3a609cd06ddb2da804f68f0",
              "name": "Royal Blue",
              "slug": "royal-blue"
            },
            {
              "id": "68d98f2fbafc0fd45651cddc44798dd0",
              "name": "Crimson Red",
              "slug": "crimson-red"
            },
            {
              "id": "996cd95c97fd5620d0a374c835b37205",
              "name": "Forrest Green",
              "slug": "forrest-green"
            }
          ]
        }
      ],
      "tax-category": "standard-taxable",
      "default-sku": "66072fb71b89448912e2681c",
      "ec-product-type": "b6ccc1830db4b1babeb06a9ac5f6dd76"
    }
  },
  "skus": [
    {
      "id": "580e63fc8c9a982ac9b8b745",
      "cmsLocaleId": "653ad57de882f528b32e810e",
      "lastPublished": "2023-03-17T18:47:35.560Z",
      "lastUpdated": "2023-03-17T18:47:35.560Z",
      "createdOn": "2023-03-17T18:47:35.560Z",
      "fieldData": {
        "name": "Blue T-shirt",
        "slug": "t-shirt-blue",
        "price": {
          "value": 2499,
          "unit": "USD",
          "currency": "USD"
        },
        "sku-values": {
          "color": "blue",
          "size": "small"
        },
        "compare-at-price": {
          "value": 100,
          "unit": "USD"
        },
        "ec-sku-billing-method": "one-time",
        "ec-sku-subscription-plan": {
          "interval": "day",
          "frequency": 1,
          "trial": 7,
          "plans": [
            {
              "platform": "stripe",
              "id": "string",
              "status": "active"
            }
          ]
        },
        "main-image": "https://www.example.com/image.jpg",
        "sku": "1234567890",
        "sku-properties": [
          {
            "id": "Color",
            "name": "Color",
            "enum": [
              {
                "id": "royal-blue",
                "name": "Royal Blue",
                "slug": "royal-blue"
              }
            ]
          }
        ]
      }
    }
  ]
}

Create a new ecommerce product and defaultSKU. A product, at minimum, must have a single SKU.

To create a product with multiple SKUs:

First, create a list of sku-properties, also known as product options. For example, a T-shirt product may have a “color” sku-property, with a list of enum values: red, yellow, and blue, another sku-property may be “size”, with a list of enum values: small, medium, and large.
Once, a product is created with a list of sku-properties, Webflow will create a default SKU, which is always a combination of the first enum values of each sku-property. (e.g. Small - Red - T-Shirt)
After creation, you can create additional SKUs for the product, using the Create SKUs endpoint.

Upon creation, the default product type will be Advanced, which ensures all Product and SKU fields will be shown to users in the Designer.

Required scope | ecommerce:write

Create a new ecommerce product and defaultSKU. A product, at minimum, must have a single SKU. To create a product with multiple SKUs: - First, create a list of `sku-properties`, also known as [product options](https://help.webflow.com/hc/en-us/articles/33961334531347-Create-product-options-and-variants). For example, a T-shirt product may have a "color" `sku-property`, with a list of enum values: red, yellow, and blue, another `sku-property` may be "size", with a list of enum values: small, medium, and large. - Once, a product is created with a list of `sku-properties`, Webflow will create a **default SKU**, which is always a combination of the first `enum` values of each `sku-property`. (e.g. Small - Red - T-Shirt) - After creation, you can create additional SKUs for the product, using the [Create SKUs endpoint.](/data/reference/ecommerce/products/create-sku) Upon creation, the default product type will be `Advanced`, which ensures all Product and SKU fields will be shown to users in the Designer. Required scope | `ecommerce:write`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

Request

The Product and SKU to create

productobjectRequired

skuobjectRequired

publishStatusenumOptionalDefaults to staging

Indicate whether your Product should be set as "staging" or "live"

Allowed values:

Response

Request was successful

productobject

The Product object

skuslist of objects

A list of SKU Objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error