> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.quivo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Products

This tutorial guides you step by step through creating your first article. An article is a product in the Quivo system. Each article must have a unique SKU that identifies it. You must create articles before you can send them as inventory to warehouses or include them in fulfillment orders.

## Prerequisites

Before you start, make sure you have:

* **Session token:** A valid session token. See the [Authentication guide](/api-reference/authentication) to learn how to obtain one.
* **Seller ID:** Use the [`GET /sellers endpoint`](/api-reference/#tag/sellers) to find it.

<Note>
  All API examples in this guide use `${BASE_URL}` as a placeholder. Replace it with the correct base URL configured for the correct environment. For more information see [Environments page](/api-reference/environments).
</Note>

## Create your first article

To create an article, use the [`POST /articles/{sellerId} endpoint`](/api-reference/#tag/articles). For warehouse processing of inbounds and orders, include at least `sku`, `name`, `barcode`, and weight (`grossWeight` or `netWeight` with `unit`).

The following example shows how to create an article with essential fields:

<Tabs>
  <Tab title="Request">
    Use this request example to create a new article with essential product data.

    ```bash theme={null}
    curl -X POST "${BASE_URL}/articles/<YOUR_SELLER_ID>" \
      -H "X-Api-Key: <YOUR_STATIC_API_KEY>" \
      -H "Authorization: <YOUR_SESSION_TOKEN>" \
      -H "Content-Type: application/json" \
      -d '{
        "sku": "<YOUR_SKU>",
        "name": {
          "value": "<PRODUCT_NAME>",
          "language": "EN"
        },
        "grossWeight": {
          "value": <WEIGHT_VALUE>,
          "unit": "KG"
        },
        "length": {
          "value": <LENGTH_VALUE>,
          "unit": "CM"
        },
        "width": {
          "value": <WIDTH_VALUE>,
          "unit": "CM"
        },
        "height": {
          "value": <HEIGHT_VALUE>,
          "unit": "CM"
        },
        "countryOfOrigin": "<COUNTRY_CODE>",
        "salesPrice": {
          "value": <PRICE_VALUE>,
          "currencyCode": "<CURRENCY_CODE>"
        }
      }'
    ```
  </Tab>

  <Tab title="Response">
    A successful request returns a `200 OK` status code with an `ArticleGetDetail` object:

    ```json theme={null}
    {
      "articleId": <YOUR_ARTICLE_ID>,
      "sellerId": <YOUR_SELLER_ID>,
      "sku": "<YOUR_SKU>",
      "name": {
        "value": "<PRODUCT_NAME>",
        "language": "EN"
      },
      "barcode": "<PRODUCT_BARCODE>",
      "grossWeight": {
        "value": <WEIGHT_VALUE>,
        "unit": "KG"
      },
      "created": "<YYYY-MM-DDTHH:mm:ssZ>",
      "lastModified": "<YYYY-MM-DDTHH:mm:ssZ>"
    }
    ```

    Save the `articleId` from the response. You need this ID to update the article or upload images later. Timestamps follow the ISO 8601 pattern YYYY-MM-DDTHH:mm:ssZ in Coordinated Universal Time UTC.
  </Tab>
</Tabs>

<Tip>
  **Required for warehouse processing:** To process inbounds and orders in the warehouse, include at least `sku`, `name`, `barcode`, and weight (`grossWeight` or `netWeight` with `unit`). For a complete list of additional fields—including `customsValue`, `alternativeNames`, and more—see the [API Reference](/api-reference/#tag/articles).
</Tip>

## Where to go next

Now that you can create articles, continue with these guides:

<CardGroup cols={2}>
  <Card title="Manage Products" icon="edit" href="/docs/quivo-guides/manage-products">
    Learn how to update articles, upload images, search your catalog, and validate product data.
  </Card>

  <Card title="Send Inventory" icon="warehouse" href="/docs/quickstart/send-inventory">
    Send your products to Quivo warehouses.
  </Card>
</CardGroup>