For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentationAPI Reference
DocumentationAPI Reference
  • API Reference
      • POSTSet ExternalSync flag for Wros
      • GETGet Multiple Warehouse Receiving Orders
      • POSTCreate Warehouse Receiving Order
      • POSTCancel Warehouse Receiving Order
      • GETGet Fulfillment Centers
      • GETGet Warehouse Receiving Order
      • GETGet Warehouse Receiving Order Boxes
      • GETGet Warehouse Receiving Order Box Labels
      • GETGet Inventory Distributions by WRO ID
LogoLogo
API ReferenceReceiving

Create Warehouse Receiving Order

||View as Markdown|
POST
https://sandbox-api.shipbob.com/2026-01/receiving
POST
/2026-01/receiving
$curl -X POST https://sandbox-api.shipbob.com/2026-01/receiving \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json-patch+json" \
>     -d '{
>  "box_packaging_type": "EverythingInOneBox",
>  "boxes": [
>    {
>      "box_items": [
>        {
>          "inventory_id": 0,
>          "quantity": 1,
>          "lot_date": "2019-08-24T14:15:22+00:00",
>          "lot_number": "2222"
>        }
>      ],
>      "tracking_number": "860C8CDC8F0B4FC7AB69AC86C20539EC"
>    }
>  ],
>  "expected_arrival_date": "2019-08-24T14:15:22+00:00",
>  "fulfillment_center": {
>    "id": 0
>  },
>  "package_type": "Package",
>  "purchase_order_number": "string"
>}'
1{
2  "box_labels_uri": "https://api.shipbob.com/2026-01/receiving/1/labels",
3  "box_packaging_type": "EverythingInOneBox",
4  "expected_arrival_date": "2019-08-24T14:15:22+00:00",
5  "external_sync_timestamp": "2019-08-24T14:15:22+00:00",
6  "fulfillment_center": {
7    "address1": "5900 W Ogden Ave",
8    "address2": "Suite 100",
9    "city": "Cicero",
10    "country": "USA",
11    "email": "example@example.com",
12    "id": 0,
13    "name": "Cicero (IL)",
14    "phone_number": "555-555-5555",
15    "state": "IL",
16    "timezone": "Central Standard Time",
17    "zip_code": "60804"
18  },
19  "id": 0,
20  "insert_date": "2019-08-24T14:15:22+00:00",
21  "inventory_quantities": [
22    {
23      "expected_quantity": 0,
24      "inventory_id": 0,
25      "received_quantity": 0,
26      "sku": "string",
27      "stowed_quantity": 0
28    }
29  ],
30  "last_updated_date": "2019-08-24T14:15:22+00:00",
31  "package_type": "Package",
32  "purchase_order_number": "string",
33  "status": "Awaiting",
34  "status_history": [
35    {
36      "id": 0,
37      "status": "Processing",
38      "timestamp": "2019-08-24T14:15:22+00:00"
39    }
40  ]
41}
Creates a new warehouse receiving order with specified fulfillment center, boxes, and inventory items.
Was this page helpful?
Previous

Get Multiple Warehouse Receiving Orders

Next

Cancel Warehouse Receiving Order

Built with

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

OR
AuthorizationBearer
OAuth2 authentication using JWT tokens

Request

The receiving order to create
box_packaging_typeenumRequired
Allowed values:
boxeslist of objectsRequired
Box shipments to be added to this receiving order
expected_arrival_datedatetimeRequired
Expected arrival date of all the box shipments in this receiving order
fulfillment_centerobjectRequired
Model containing information that assigns a receiving order to a fulfillment center. If the fulfillment center provided is in a receiving hub region, then the response will be the receiving hub location.
package_typeenumRequired
Allowed values:
purchase_order_numberstringOptional
Purchase order number for this receiving order

Response

Success
box_labels_uristring
URL to the packing slip to be included in each box shipment for this receiving order
box_packaging_typeenum
Allowed values:
expected_arrival_datedatetime
Expected date that all packages will have arrived
external_sync_timestampdatetime
The timestamp in UTC when a 3rd party integrator has set in our system
fulfillment_centerobject
Information about a fulfillment center
idinteger
Unique id of the warehouse receiving order
insert_datedatetime
Insert date of the receiving order
inventory_quantitieslist of objects
Inventory items and quantities within the WRO
last_updated_datedatetime
Last date the receiving order was updated
package_typeenum
Allowed values:
purchase_order_numberstring
Purchase order number for a receiving order
statusenum
status_historylist of objects
The history of status changes for this receiving order

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error