Skip to main content
POST
/
client
/
shipments
/
create
Create a shipment
curl --request POST \
  --url https://api.ship.uniuni.com/prod/client/shipments/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipient": {
    "name": "Jane Doe",
    "phone": "+1-604-123-4567",
    "email": "jane@example.com",
    "signature": false
  },
  "address": {
    "address1": "3460 Cawthra Road",
    "city": "Mississauga",
    "province": "ON",
    "postalCode": "L5A 2Y1",
    "country": "CA"
  },
  "dimensions": {
    "length": 1,
    "width": 1,
    "height": 1,
    "dimensionUnit": "INCH"
  },
  "weight": {
    "value": 1,
    "weightUnit": "LB"
  },
  "postageType": "STANDARD",
  "note": "Gift Box",
  "shipmentLineItems": [
    {
      "description": "T-shirt",
      "quantity": 1,
      "unit_value": 10,
      "currency": "CAD"
    }
  ]
}
'
{
  "message": "Shipment created successfully",
  "code": 0,
  "data": {
    "orderNumber": "UNI031455E90",
    "trackingId": "UR07300000000005351",
    "recipient": {
      "name": "Jane Doe",
      "phone": "+1-604-123-4567",
      "email": "jane@example.com"
    },
    "address": {
      "address1": "2455 Meadowvale Blvd",
      "city": "Mississauga",
      "province": "ON",
      "postalCode": "L5N 0H1",
      "country": "CA"
    },
    "dimensions": {
      "length": 1,
      "width": 1,
      "height": 1,
      "dimensionUnit": "INCH"
    },
    "weight": {
      "value": 1,
      "weightUnit": "LB"
    },
    "status": "DRAFT",
    "note": "Gift Box",
    "createdAt": "2025-07-30T18:32:11.455Z",
    "updatedAt": "2025-07-30T18:32:11.899Z",
    "rates": {
      "postageType": "NEXT DAY",
      "postageFee": 4.88,
      "tax": 0.63,
      "total": 5.51,
      "currency": "CAD"
    },
    "shipmentLineItems": [
      {
        "description": "T-shirt",
        "quantity": 1,
        "unit_value": 10,
        "currency": "CAD"
      }
    ]
  }
}
Once you’ve purchased a shipment and printed the label, visit ship.uniuni.com/locations to confirm your drop-off location or ship.uniuni.com/pickups to request a pick-up service (if available).
shipmentLineItems is required. Every shipment must include at least one line item (shipmentLineItems array with >= 1 element). Omitting it or sending an empty array returns a 422 PayloadValidationError.
Cross-border shipments (CA → US): Each item in shipmentLineItems must also include hs_code, country_of_origin, and a description identifying the manufacturer. Shipments missing this information may be held at the border.

Authorizations

​
Authorization
string
header
required

API access token generated from the UniUni Platform dashboard.

Body

application/json
​
recipient
object
required
​
address
object
required
​
weight
object
required
​
shipmentLineItems
object[]
required

Line items describing the contents. Must contain at least one item.

Minimum array length: 1
​
dimensions
object

Package dimensions. Provide either dimensions or packagingId, not both.

​
packagingId
integer

ID of a pre-configured packaging profile. Use instead of dimensions if the package matches a saved profile.

​
postageType
enum<string>

Preferred postage type. Domestic shipments typically use SAME DAY, NEXT DAY, or STANDARD. Cross-border CA→US shipments use USPS Ground Advantage (DDP) or PostNL International Packet Tracked (DDU). If the requested type is unavailable, an available type is selected automatically.

Available options:
PUBLICATION,
SAME DAY,
NEXT DAY,
STANDARD,
USPS Ground Advantage,
PostNL International Packet Tracked,
OTHER
​
note
string

Optional note, up to 200 characters.

Maximum string length: 200
​
insuranceRequired
boolean

Whether parcel protection (insurance) is required for this shipment.

​
orderNumber
string

Optional client-provided order reference.

Response

Shipment created or error returned

​
message
string
required

Additional information about the request status.

​
code
integer
required

Status code. 0 indicates success.

​
data
object