Skip to main content
POST
Create a customer order

Authorizations

Authorization
string
header
required

API key as a bearer token. Secret keys (sk_) allow writes; publishable keys (pk_) are read-only. live = production, test = sandbox.

Headers

Idempotency-Key
string

A unique key (UUID) that makes a write request safely retryable.

Body

application/json
recipient
object
required
reference
string

Your own order reference

delivery_method
enum<string>

How the customer receives the parcel. station_pickup = collect at a delivery station (base fee only). last_mile = rider delivers from the station to the door (base + station last-mile fee).

Available options:
station_pickup,
last_mile
item
object

Parcel summary used for the shipment.

items
object[]

Cart line items. Each item's total_price is computed (quantity × unit_price).

origin
object

Response

Order created.

order
object