Create Parcel - Post Packing API

Complete parameter reference for confirming parcels in the Post Packing flow. This API confirms that a parcel has been physically packed and is ready for pickup and delivery.

API Endpoint

Method	Endpoint	Content-Type
`PUT`	`api.integration.instabee.com/orders` (production) `sandbox-api.integration.instabee.com/orders` (sandbox)	`application/json`

Integration Levels

You can integrate at different levels depending on your workflow:

Bare Minimum Integration

If everything was sent in the Post Purchase call, you only need:

{
  "availabilityToken": "b4a9c200-c02a-4186-b3e8-6271a0be2190",
  "parcelPackingConfirmed": true
}

Minimum Integration

Basic confirmation with essential parcel details:

{
  "parcelId": "PREFIX1234567890",
  "brand": "instabox",
  "product": "LOCKER_EXPRESS",
  "parcelPackingConfirmed": true,
  "recipient": {
    "name": "Test Testsson",
    "email": "test@instabee.com",
    "phone": "0701234567",
    "street": "Hälsingegatan 40",
    "street2": "Floor 10",
    "postalCode": "12345",
    "city": "Stockholm",
    "countryCode": "SE"
  },
  "deliveryOption": {
    "sort_code": "IN123"
  },
  "cart": {
    "orderNumber": "12345"
  }
}

Root Parameters

Parameter	Type	Required	Description	Example
`parcelPackingConfirmed`	boolean	required	Confirms that the parcel has been packed and is ready for pickup	`true`
`availabilityToken`	string	conditional	Token from Availability API or Post Purchase response	`"b4a9c200-c02a-4186-b3e8-6271a0be2190"`
`parcelId`	string	conditional	Parcel identifier from Post Purchase response	`"PREFIX1234567890"`
`brand`	string	conditional	Delivery brand (required if not sent in Post Purchase)	`"instabox"`, `"budbee"`
`product`	string	conditional	Product type for delivery (required if not sent in Post Purchase)	`"LOCKER_EXPRESS"`, `"LOCKER_RETURN"`, `"HOME_DELIVERY"`, `"LOCKER_CAPACITY_SURPLUS"`, `"LOCKER_ALLOCATION"`, `"LOCKER_AREA"`

LOCKER_RETURN Parameters

The following parameters are specific to the LOCKER_RETURN product type. For locker returns, parcelPackingConfirmed should always be set to true as the order is sent as completed.

Parameter	Type	Required	Description	Example
`isLabelless`	boolean	optional	Indicates if the return is labelless. When `true`, the consumer does not need to attach a label to the parcel. When `false` or omitted, a label is expected to be attached by the consumer.	`true`
`associatedParcelId`	string	optional	The parcel ID of the outbound delivery. When provided, the return order will not be created until the outbound parcel has been delivered. If omitted, the order is treated as a standalone return order.	`"PREFIX1234567890"`

Example: LOCKER_RETURN with Associated Parcel

{
  "parcelId": "PREFIX1234567891",
  "brand": "instabox",
  "product": "LOCKER_RETURN",
  "parcelPackingConfirmed": true,
  "isLabelless": true,
  "associatedParcelId": "PREFIX1234567890",
  "sender": {
    "name": "Test Testsson",
    "email": "test@instabee.com",
    "phone": "0701234567",
    "street": "Hälsingegatan 40",
    "postalCode": "12345",
    "city": "Stockholm",
    "countryCode": "SE"
  },
  "deliveryOption": {
    "sort_code": "IN123"
  },
  "cart": {
    "orderNumber": "12345"
  }
}

Parcel Dimensions (Optional)

If the actual dimensions differ from your initial estimates, you can update them:

Parameter	Type	Required	Description	Example
`cart.parcel.heightMm`	number	optional	Final height in centimeters	`10`
`cart.parcel.widthMm`	number	optional	Final width in centimeters	`10`
`cart.parcel.lengthMm`	number	optional	Final length in centimeters	`10`
`cart.parcel.weightGram`	number	optional	Final weight in grams	`2000`
`cart.parcel.volumeDm3`	number	optional	Final volume in liters	`1`

Response

The Post Packing API response includes:

Shipping Labels - Download URLs for shipping labels
Pickup Information - When and where the parcel will be collected
Tracking Information - Tracking numbers and status updates
Delivery Details - Final delivery information for the customer