---
updatedAt: 2026-06-30T16:05:21.000Z
agentTools:
  projectIndex: https://docs.pelcro.com/llms.txt
---

# Create SKU

Create a new product SKU.

## Overview

Create a new SKU (product variant) for an e-commerce product. SKUs define specific variants with their own price, inventory, and attributes.

**Example:** Add a "Large/Blue" variant to a t-shirt product with its own price and inventory count.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "core-api",
    "version": "1.88"
  },
  "servers": [
    {
      "url": "https://www.pelcro.com/api/v1/core"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      },
      "sec1": {
        "type": "apiKey",
        "in": "query",
        "name": "site_id"
      }
    }
  },
  "security": [
    {
      "sec0": [],
      "sec1": []
    }
  ],
  "paths": {
    "/ecommerce/products/skus": {
      "post": {
        "summary": "Create SKU",
        "description": "Create a new product SKU.",
        "operationId": "api-core-create-sku",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Bearer eyJ***"
            }
          },
          {
            "name": "site_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "The unique identifier of the site associated with your account."
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "product_id",
                  "name",
                  "inventory_type",
                  "currency",
                  "active",
                  "price"
                ],
                "properties": {
                  "product_id": {
                    "type": "integer",
                    "description": "The unique identifier of the product.",
                    "format": "int32"
                  },
                  "name": {
                    "type": "string",
                    "description": "The name of the SKU"
                  },
                  "inventory_type": {
                    "type": "boolean",
                    "description": "The inventory type should be 0 if it's unlimited quantity or 1 if it's limited"
                  },
                  "inventory_quantity": {
                    "type": "integer",
                    "description": "The quantity of the SKU if the inventory_type is set to 1",
                    "format": "int32"
                  },
                  "currency": {
                    "type": "string",
                    "description": "The ISO code currency of the SKU"
                  },
                  "active": {
                    "type": "boolean",
                    "description": "A boolean value to state whether or not that SKU is active"
                  },
                  "price": {
                    "type": "integer",
                    "description": "The price of the SKU in cents",
                    "format": "int32"
                  },
                  "image": {
                    "type": "string",
                    "description": "The of the image of the SKU"
                  },
                  "expires_at": {
                    "type": "string",
                    "description": "The expiration date of the SKU if any",
                    "format": "date"
                  },
                  "entitlements": {
                    "type": "array",
                    "description": "The entitlements of offerings which are available on the selected SKU",
                    "items": {
                      "type": "string"
                    }
                  },
                  "metadata": {
                    "type": "array",
                    "description": "Set of key-value pairs that can be saved on sku level. This can be useful for storing additional information about the object in a structured format."
                  },
                  "countries": {
                    "type": "array",
                    "description": "The regions where the SKU should be available e.g., [\"US\", \"CA\", \"GB\"].",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "product_id": {
                          "type": "integer"
                        },
                        "name": {
                          "type": "string"
                        },
                        "active": {
                          "type": "boolean"
                        },
                        "currency": {
                          "type": "string"
                        },
                        "countries": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "nullable": true
                        },
                        "image": {
                          "type": "string",
                          "nullable": true
                        },
                        "inventory_type": {
                          "type": "integer"
                        },
                        "inventory_quantity": {
                          "type": "integer",
                          "nullable": true
                        },
                        "inventory_description": {
                          "type": "string",
                          "nullable": true
                        },
                        "price": {
                          "type": "integer"
                        },
                        "weight": {
                          "type": "number",
                          "nullable": true
                        },
                        "metadata": {
                          "type": "object",
                          "nullable": true
                        },
                        "expires_at": {
                          "type": "integer",
                          "format": "int64",
                          "nullable": true
                        },
                        "entitlements": {
                          "type": "array",
                          "nullable": true
                        },
                        "created_at": {
                          "type": "integer",
                          "format": "int64"
                        },
                        "updated_at": {
                          "type": "integer",
                          "format": "int64"
                        }
                      }
                    },
                    "status": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "Result": {
                    "value": {
                      "data": {
                        "id": 99,
                        "product_id": 42,
                        "name": "Standard Edition",
                        "active": true,
                        "currency": "usd",
                        "countries": [
                          "US",
                          "CA"
                        ],
                        "image": null,
                        "inventory_type": 0,
                        "inventory_quantity": null,
                        "inventory_description": null,
                        "price": 2500,
                        "weight": 0,
                        "metadata": {
                          "color": "blue"
                        },
                        "expires_at": null,
                        "entitlements": [
                          "premium_access"
                        ],
                        "created_at": 1712188800,
                        "updated_at": 1712188800
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request.",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "401": {
            "description": "Unauthenticated.",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "error": "Unauthenticated."
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```

# Sibling pages

* [List SKUs](https://docs.pelcro.com/reference/api-core-list-ecommerce-skus.md)
* [Get SKU](https://docs.pelcro.com/reference/api-core-get-ecommerce-sku.md)
* [Update SKU](https://docs.pelcro.com/reference/api-core-update-ecommerce-sku.md)
* [Delete SKU](https://docs.pelcro.com/reference/api-core-delete-ecommerce-sku.md)