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

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

// A second box, or a freight consignment: the carrier is free text, so a
// forwarder's PRO number is as valid as a parcel number.
const delivery = await client.orders.fulfillments.deliveries.create(
  'or_UkLWZg9DAJ',
  'ful_UkLWZg9DAJ',
  { tracking_number: 'PRO-4471923', carrier: 'Estes Freight' },
)

spree api post /orders/{order_id}/fulfillments/{fulfillment_id}/deliveries -d '{"tracking_number":"PRO-4471923","carrier":"Estes Freight"}'

{
  "id": "dlv_gbHJdmfrXB",
  "tracking_number": "1Z879E930346834440",
  "carrier": "ups",
  "carrier_name": "UPS",
  "service": null,
  "status": "pending",
  "tracking_url": "https://www.ups.com/track?tracknum=1Z879E930346834440",
  "estimated_delivery_at": null,
  "delivered_at": null,
  "details": null,
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "shipping_label_id": null
}

{
  "error": {
    "code": "validation_error",
    "message": "Tracking number has already been taken",
    "details": {
      "tracking_number": [
        {
          "value": "U10000",
          "code": "taken",
          "message": "has already been taken",
          "specific": false
        }
      ]
    }
  }
}