import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

// With no body, the parcel's carrier account buys the label.
const label = await client.orders.fulfillments.labels.create('or_UkLWZg9DAJ', 'ful_UkLWZg9DAJ')

// The tracking number is now on the parcel's first delivery, and the label is
// ready to print. What the merchant paid the carrier is label.display_cost.

spree api post /orders/{order_id}/fulfillments/{fulfillment_id}/labels -d '{ ... }'

{
  "id": "lbl_UkLWZg9DAJ",
  "source": "purchased",
  "status": "purchased",
  "carrier": "ups",
  "carrier_name": "UPS",
  "service": "Ground",
  "tracking_number": "1Z879E930346834440",
  "currency": "USD",
  "format": "pdf",
  "external_id": "shp_1",
  "metadata": {
    "tracker_id": "trk_1",
    "file_url": "https://carrier.example/label.pdf"
  },
  "refunded_at": null,
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "owner_id": "ful_UkLWZg9DAJ",
  "owner_type": "fulfillment",
  "cost": "7.25",
  "integration_id": null,
  "file_pending": true,
  "download_url": "/api/v3/admin/orders/or_UkLWZg9DAJ/fulfillments/ful_UkLWZg9DAJ/labels/lbl_UkLWZg9DAJ/download"
}

{
  "error": {
    "code": "processing_error",
    "message": "This delivery method's provider does not produce labels"
  }
}