Skip to main content
POST
Purchase Shipping Label
V2 Preview — This endpoint is part of the V2 API preview. Breaking changes may occur.

Overview

Purchase a shipping label for an order after selecting a rate from the Get Shipping Rates endpoint. Provide the same shipment details plus the chosen service code and carrier.

Use Cases

  • Purchase a label after a vendor selects a rate
  • Automate label generation in fulfillment workflows
  • Integrate carrier label purchase into custom shipping UIs

Request Body

Accepts the same fields as Get Shipping Rates, plus:
string | number
required
The Shopify order number.
string
required
The vendor’s ID.
string[]
required
Array of line item IDs to ship. Minimum 1 item.
string
required
The service code from the selected rate (e.g. usps_priority).
string
required
The shipping carrier provider (e.g. shippo, shipstation).
string
Carrier-specific code (e.g. usps, ups, fedex).
number
Package length. Must be a positive number.
number
Package width. Must be a positive number.
number
Package height. Must be a positive number.
number
Package weight. Must be a positive number.
string
Weight unit (e.g. lb, kg, oz, g).
string
Distance unit for dimensions (e.g. in, cm).
object
Destination address. See Get Shipping Rates for field details.
object
Origin address. See Get Shipping Rates for field details.

Response

200

Example

More Examples

Purchase a USPS Priority Mail label