Skip to main content
POST
/
api
/
v2
/
packages
Create Son package
curl --request POST \
  --url https://live.nocnocstore.com/api/v2/packages \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "order_reference_id": "<string>",
  "labels": [
    {}
  ],
  "items": [
    {}
  ]
}
'
{
  "package_id": "PK111"
}
nocnoc manages two types of packages: Son and Father. Create a Son package per order, then group multiple Son packages into a Father package for consolidated first-mile shipping.

​
Authorization

​
X-Api-Key
string
required
Your seller API key. Provided by your nocnoc account manager.

​
Body parameters

​
order_reference_id
string
required
The reference ID of the order included in this package.
​
labels
array
required
Array of label objects. Minimum 1, maximum 10. Each object contains:
  • tracking_code (string) — tracking code of the package
  • carrier (string) — first-mile carrier (e.g. "FedEx", "UPS"). Use "nocnoc" for a nocnoc label
  • url (string) — URL to track the order
​
items
array
required
Array of item objects inside the package. Minimum 1, maximum 10. Each object contains:
  • sku (string) — item SKU, between 1 and 45 characters
  • quantity (integer) — quantity of the item, between 0 and 9999

​
Returns

The created Son package object with its package ID, which you’ll need to create a Father package.

​
Example request

curl -X POST https://live.nocnocstore.com/api/v2/packages \
  -H "X-Api-Key: YOUR_SELLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_reference_id": "NC0000",
    "labels": [
      {
        "tracking_code": "1234",
        "carrier": "nocnoc",
        "url": "https://tracking.example.com/1234"
      }
    ],
    "items": [
      {
        "sku": "SKU00000000",
        "quantity": 1
      }
    ]
  }'

{
  "package_id": "PK111"
}