Create Shipment

Create a UPS shipment. This will return an image of the shipping label in ZPL203, PDF or PNG format.

Body Params

Shipment Details

Create Shipment Request

ShipmentInformation
object
required

Used to provide shipment-level information such as service code, content type, general goods description, total shipment weight and value etc.

Shipper
object
required

Used to provide shipper details such as address, contact details, VAT and EORI number etc.

Destination
object
required

An object providing details on the shipment destination, such as receiver and contact details.

CarrierSpecifics
object

UPS - specific features that can be used when creating a UPS shipment.

Packages
array of objects
required

Shipment Packages
The packages that are being sent in this shipment.
There must be at least 1 package.
A maximum of 50 packages are allowed for Domestic services
A maximum of 20 packages are allowed for International services

Packages*
Items
array of objects | null

Used to provide information on the individual goods/products being shipped within the package. This includes vital details, such as SKU code for inventory tracking, quantity of each item, description for clarity, and shipping specifics like weight, customs classifications (HS Code), and country of origin.

Note: The item information is only required for dutiable shipments. Non-Dutiable and Documents Only (DOX) shipments do not require item information. Please be advised that the item verification on a shipment is done via Hurricane services; therefore, it should be enabled. The maximum number of distinct items that will be verified in a single shipment is 15.

Items
Customs
object

Used to provide information for customs clearance related to the shipment. This includes, reasons for export, applicable incoterms, any pre-registration numbers and type required, shipping and other charges, as well as details about the invoice and whether an export licence is needed. It ensures compliance with international shipping regulations.

ReturnToSender
object

Used to provide the address details to be used when returning the shipment back to the sender.

Note: If this information is not provided, then the shipping location's address is used.
Ignored for UPS shipments - field not required, as UPS shipments will be returned to the Shipper's address

Responses

401

Unauthorized

403

Forbidden

404

The carrier was not found.

500

Internal Server Error

Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json