---
title: "Create products"
method: POST
path: "/v2/products/create"
tags: ["products"]
---

# Create products

`POST /v2/products/create`

<aside class="access" aria-label="Endpoint access">
      <table class="access__table">
        <thead>
          <tr>
            <th class="access__table-header">Products</th>
            <th class="access__table-header">Plans</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td class="access__table-cell access__product">
              <img class="access__logo" src="/static/logos/shipstation-api-logo.svg" alt="ShipStation API Logo" loading="lazy" decoding="async"/>
              <div class="access__sub">Formerly ShipEngine</div>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-free.md" class="access__plan access__plan--off">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Advanced</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Enterprise</a>
            </td>
          </tr>
          <tr>
            <td class="access__table-cell">
              <img class="access__logo" src="/static/logos/shipstation-logo.svg" alt="ShipStation Logo" loading="lazy" decoding="async"/>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Starter</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Standard</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Premium</a>
            </td>
          </tr>
        </tbody>
      </table>
      <footer class="access__footer">
        <a class="access__help" href="/apis/@shipstation-v2/docs/getting-started/products-and-plans.md">
          Learn about products and plans
          <img src="/static/icons/external-link.svg" alt="External Link Icon" style="width: 16px;" loading="lazy" decoding="async"/>
        </a>
      </footer>
    </aside>

## Request body

- object
  - `products` object[], required — Array of products to create
    - `sku` string, required — Stock Keeping Unit identifier. Must be unique within your account.
    - `name` string, required — Product name
    - `upc` string, nullable — Universal Product Code
    - `thumbnail_url` string, nullable — URL to product thumbnail image
    - `price` object
      - `currency` string — Currency code
      - `amount` number — Price amount
    - `dimensions` object
      - `unit` string — Unit of measurement
      - `length` number — Length dimension
      - `width` number — Width dimension
      - `height` number — Height dimension
    - `weight` object
      - `value` number — Weight value
      - `unit` string — Weight unit
    - `internal_notes` string, nullable — Internal notes about the product
    - `fulfillment_sku` string, nullable — Fulfillment SKU
    - `active` boolean — Whether the product is active
    - `product_category` object, nullable
      - `product_category_id` integer
      - `name` string
    - `preset_group` string, nullable — Preset group
    - `warehouse_location` string, nullable — Warehouse location
    - `default_carrier_code` string, nullable — Default carrier code
    - `default_service_code` string, nullable — Default service code
    - `default_package_code` string, nullable — Default package code
    - `default_intl_carrier_code` string, nullable — Default international carrier code
    - `default_intl_service_code` string, nullable — Default international service code
    - `default_intl_package_code` string, nullable — Default international package code
    - `default_confirmation` string, nullable — Default confirmation type
    - `default_intl_confirmation` string, nullable — Default international confirmation type
    - `customs_description` string, nullable — Customs description
    - `customs_value` number, nullable — Customs value
    - `customs_tariff_no` string, nullable — Customs tariff number
    - `customs_country_code` string, nullable — Customs country code
    - `no_customs` boolean, nullable — Whether customs is required
    - `tags` object[], nullable — Tags to assign. Only `tag_id` is used on write; `name` and `color` are response-only fields returned when reading a product.
      - `tag_id` integer
    - `aliases` object[], nullable
      - `store_id` integer
      - `sku_alias` string
    - `is_returnable` boolean, nullable — Whether the product is returnable
    - `should_override_name` boolean, nullable — Whether to override the product name
    - `is_bundle` boolean, nullable — Whether the product is a bundle
    - `auto_split_option` string, nullable — Auto split option
    - `auto_split_custom_quantity` integer, nullable — Auto split custom quantity when auto_split_option is set to custom_quantity

## Response `200`

The products were created successfully

- object
  - `created_product_ids` integer[] — IDs of the newly created products
  - `request_id` string — Unique identifier for this request
  - `errors` object[] — Any errors that occurred during creation
    - `error_source` string
    - `error_type` string
    - `error_code` string
    - `message` string
    - `field_name` string

## Other responses

- `400` — The request contained errors.
- `500` — The request was successful.

---

[API](https://skmtc.net/shipstation/apis/shipstation-api-v2.md) · [All operations](https://skmtc.net/shipstation/apis/shipstation-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipstation-api-v2/revisions/d3d8c21cd227/schema)