Create order

POST https://staging-v2.sparqle.tech/orders

📦 Order Creation & Bundling Workflow

There are two ways to create multiple orders and group them into a single delivery bundle using the orderBundle system:

✅ Preferred Method: Explicit Bundling via orderBundleId

1. Create the first order without an orderBundleId. The response will include an orderBundle object:

json

"orderBundle": {
    "id": 2829,
    "bundleId": "VNN1UY7TMSY81P8Q4A2C7"
}

1. Use the returned bundleId to create additional orders and connect them to the same delivery bundle:

json

{
    "orderRef": "O-TEST-2",
    "orderBundleId": "VNN1UY7TMSY81P8Q4A2C7",
    ...
}

This method is most versatile, as it allows different orderRefs, dimensions, weight and other customizations per order.

⚡ Alternative Method: Implicit Bundling via load

You can create multiple bundled orders in one request by setting the load value to the desired number:

json

{
    "orderRef": "O-TEST",
    "load": 2,
    ...
}

1. The API will generate load number of orders, all bundled under the same orderBundle.
2. Only one of the created orders is returned in the response.
3. All orders will have identical specs (dimensions, address, etc.).

Use this for quick bulk creation, but note that it’s less flexible than the explicit bundling method.