Create a freight package (pallet, crate, custom)
Inserts a fulfillment.packages row tagged with freight-specific fields
(NMFC class, NMFC code, pallet count, declared value, accessorials,
dimensions). The order must already be flagged as freight
(assertOrderIsFreight gate, returns 400 order_not_freight
otherwise). The canonical handler emits an order.package_added realtime
broadcast plus a freight.package_added activity log entry. Idempotent on
Idempotency-Key. Requires the orders:write scope.
Note: is_hazmat and hazmat_details removed 2026-05-22 (HAZMAT-SCRUB).
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Body
pallet, crate, custom NMFC freight class (50, 55, 60, 65, 70, 77.5, 85, 92.5, 100, 110, 125, 150, 175, 200, 250, 300, 400, 500).
"100"
x >= 0x >= 12
x >= 01200
Free-form pallet dimensions object (e.g. { length: 48, width: 40, height: 60 } in inches).
Accessorial codes (LIFTGATE_DEL, INSIDE_DEL, RESIDENTIAL, NOTIFY, etc.).
Optional package_items rows to insert atomically with the package.
Response
Freight package created

