Create a booking item
POST /api/v5/bookings/{id}/items
POST
/api/v5/bookings/{id}/items
Adds an item line (description, weight in kg, length/width/height in cm, quantity) to the booking and recalculates the booking total weight. Requires an API key and booking ownership. Not permitted on Multipick bookings.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string
The booking ID.
Request Body
Section titled “Request Body ”object
description
Package type or contents description (e.g. “Carton”).
string
weight
required
Item weight in kg.
number
length
required
Item length in cm.
number
width
required
Item width in cm.
number
height
required
Item height in cm.
number
quantity
required
Number of identical items of these dimensions.
integer
Responses
Section titled “ Responses ”Created booking item
object
id
required
Booking item identifier.
number
description
required
Package type or contents description.
string
weight
required
Item weight in kg.
number
length
required
Item length in cm.
number
width
required
Item width in cm.
number
height
required
Item height in cm.
number
quantity
required
Number of identical items of these dimensions.
number
Invalid item mutation
object
error
Single error message describing the failure.
string
errors
Any of:
string
Array<string>
Missing or invalid API key
Booking not found