Skip to main content
This tutorial guides you step by step through creating a fulfillment order and triggering the “Pick & Pack” process in the warehouse for your products.

​
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 the order request

To create an order, construct a JSON object that matches the OrderPost schema using the POST /orders endpoint. You must provide four main fields in the payload:
  1. Seller Context: Identifies the merchant account sellerId.
  2. Order Identifiers: Unique IDs to track the order and prevent duplicates orderIdentifier and orderReference.
  3. Delivery Address: The destination for the package deliveryAddress.
  4. Order Positions: The list of items to ship positions, including SKUs, names, and quantities.
The following example shows an order payload with all required fields:
Use this request to create a new fulfillment order with basic delivery and position data.
curl -X POST "${BASE_URL}/orders" \
  -H "X-Api-Key: <YOUR_STATIC_API_KEY>" \
  -H "Authorization: <YOUR_SESSION_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "sellerId": <YOUR_SELLER_ID>,
    "orderIdentifier": "<YOUR_ORDER_IDENTIFIER>",
    "orderReference": "<YOUR_ORDER_REFERENCE>",
    "deliveryAddress": {
      "company": "<YOUR_COMPANY_NAME>",
      "name": "<RECIPIENT_NAME>",
      "email": "<RECIPIENT_EMAIL>",
      "street": "<YOUR_STREET_ADDRESS>",
      "city": "<YOUR_CITY>",
      "zip": "<YOUR_ZIP_CODE>",
      "countryIso2": "<YOUR_COUNTRY_CODE>"
    },
    "positions": [
      {
        "sku": "<YOUR_SKU>",
        "name": "<PRODUCT_NAME>",
        "quantity": <QUANTITY>
      },
      {
        "sku": "<YOUR_SKU>",
        "name": "<PRODUCT_NAME>",
        "quantity": <QUANTITY>
      }
    ]
  }'
For the complete order request schema—including all required and optional fields—see the Orders section in the API Reference.

​
Where to go next

Now that you have created the order, the warehouse team receives the Pick & Pack instruction automatically. Continue with these guides:

Track an Order

Monitor order status and retrieve tracking information when Quivo ships the order.

Manage Webhooks

Set up webhooks to receive automatic notifications when order status changes or when Quivo generates tracking numbers.