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

# createShipment - Ship items of a Connect order

`POST /orders/{order_id}/shipments`

> **Deprecated.**

<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). We recommend integrating this API in synchronous mode, directly in your shipment creation process.

<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

- CreateShipmentRequest — 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

## Response `201`

Success. The shipment has been created.

- ShipmentResponse
  - `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> - ...
  - `channel_shipment_id` string, required — Shipment identifier on the sales channel. This identifier is unique for a sales channel, but multiple channels can use the same identifier.
  - `created_at` string, date-time, required — Shipment creation date
  - `id` string, required — Unique shipment identifier used by Connect. This identifier can be used as a primary key, but it must not be shared with final users.
  - `items` ShipmentItemResponse[], required — Items to ship
    - `id` string, required — Seller product identifier on the channel
    - `order_line_id` string, required — Order line identifier
    - `quantity` integer, required — Product quantity to ship
  - `tracking_number` string — Carrier tracking number
  - `tracking_url` string — Carrier tracking URL
  - `updated_at` string, date-time, required — Date of last shipment modification

## 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)