---
title: "v2-createShipment - Ship items of a Connect order"
method: POST
path: "/v2/orders/{order_id}/shipments"
tags: ["Shipments"]
---

# v2-createShipment - Ship items of a Connect order

`POST /v2/orders/{order_id}/shipments`

<div class="extension-title">Description</div>

Use this API to ship one or more items from the same order within the same package (using the same tracking information).

<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: On each new shipment</div>
<div class="max-call-frequency">Maximum usage: On each new shipment</div>
</div>

## Path parameters

- `order_id` string, required

## Request body

- V2CreateShipmentRequest — Shipment object and its items' details
  - `carrier` string — Carrier company name. For example: - <code>UPS</code> - <code>DHL Express</code> - <code>Amazon Logistics UK</code> - <code>FedEx</code> - <code>China Post</code> - ...
  - `items` CreateShipmentItemRequest[], required — Shipment items
    - `id` string — Seller product identifier
    - `order_line_id` string — Order line identifier
    - `quantity` integer, required — Product quantity to ship
  - `return_tracking_number` string — Return shipment tracking number is required only for marketplaces that expect return tracking information when the shipment is created. If the marketplace doesn't require it to create the shipment, the value won't be synchronized.
  - `tracking_number` string — Carrier tracking number
  - `tracking_url` string — Carrier tracking URL
  - `warehouse_id` string — Identifier of the warehouse from which the items are shipped. Optional; ignored by channels that do not require it.

## Response `202`

Success. The shipment has been created.

- AsynchronousActionResponse
  - `action_id` string, required — The unique identifier for the asynchronous action. It should be used with the [v2-getActionStatus API](#operation/v2-getActionStatus) to retrieve current action status and potential errors.
  - `tracking_id` string — **Deprecated:** This field was previously used to obtain the action ID. It has been replaced by `action_id` and contains the same value. It is retained for backward compatibility.

## Other responses

- `400` — Failure. The shipment has not been created because of wrong parameters.
- `404` — Failure. The shipment has not been created because the order was missing.

---

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