Skip to main content

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.

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:
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.

​
Create your first article

To create an article, use the POST /articles/{sellerId} endpoint. 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:
Use this request example to create a new article with essential product data.
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>"
    }
  }'
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.

​
Where to go next

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

Manage Products

Learn how to update articles, upload images, search your catalog, and validate product data.

Send Inventory

Send your products to Quivo warehouses.