Create Warehouse Receiving Order | ShipBob Developer API

curl -X POST https://api.shipbob.com/2026-01/receiving \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "box_packaging_type": "EverythingInOneBox",
  "boxes": [
    {
      "box_items": [
        {
          "inventory_id": 0,
          "quantity": 1,
          "lot_date": "2019-08-24T14:15:22Z",
          "lot_number": "2222"
        }
      ],
      "tracking_number": "860C8CDC8F0B4FC7AB69AC86C20539EC"
    }
  ],
  "expected_arrival_date": "2019-08-24T14:15:22Z",
  "fulfillment_center": {
    "id": 0
  },
  "package_type": "Package",
  "purchase_order_number": "string"
}'

{
  "box_labels_uri": "https://api.shipbob.com/2026-01/receiving/1/labels",
  "box_packaging_type": "EverythingInOneBox",
  "expected_arrival_date": "2019-08-24T14:15:22Z",
  "external_sync_timestamp": "2019-08-24T14:15:22Z",
  "fulfillment_center": {
    "address1": "5900 W Ogden Ave",
    "address2": "Suite 100",
    "city": "Cicero",
    "country": "USA",
    "email": "example@example.com",
    "id": 0,
    "name": "Cicero (IL)",
    "phone_number": "555-555-5555",
    "state": "IL",
    "timezone": "Central Standard Time",
    "zip_code": "60804"
  },
  "id": 0,
  "insert_date": "2019-08-24T14:15:22Z",
  "inventory_quantities": [
    {
      "expected_quantity": 0,
      "inventory_id": 0,
      "received_quantity": 0,
      "sku": "string",
      "stowed_quantity": 0
    }
  ],
  "last_updated_date": "2019-08-24T14:15:22Z",
  "package_type": "Package",
  "purchase_order_number": "string",
  "status": "Awaiting",
  "status_history": [
    {
      "id": 0,
      "status": "Processing",
      "timestamp": "2019-08-24T14:15:22Z"
    }
  ]
}

Creates a new warehouse receiving order with specified fulfillment center, boxes, and inventory items.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token or OAuth2

Request

The receiving order to create

box_packaging_typeenumRequired

Allowed values:

boxeslist of objects or nullRequired

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_numberstring or nullOptional

Purchase order number for this receiving order

Response

Success

box_labels_uristring or null

URL to the packing slip to be included in each box shipment for this receiving order

box_packaging_typeenum or null

Allowed values:

expected_arrival_datedatetime or null

Expected date that all packages will have arrived

external_sync_timestampdatetime or null

The timestamp in UTC when a 3rd party integrator has set in our system

fulfillment_centerobject or null

Information about a fulfillment center

idinteger or null

Unique id of the warehouse receiving order

insert_datedatetime or null

Insert date of the receiving order

inventory_quantitieslist of objects or null

Inventory items and quantities within the WRO

last_updated_datedatetime or null

Last date the receiving order was updated

package_typeenum or null

Allowed values:

purchase_order_numberstring or null

Purchase order number for a receiving order

statusenum or null

status_historylist of objects or null

The history of status changes for this receiving order

Authentication

Request

Response

Errors