Create Warehouse Receiving Order | ShipBob Developer API

curl -X POST https://sandbox-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

AuthorizationBearer

OAuth2 authentication using JWT tokens

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

Allowed values:

expected_arrival_datedatetime

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

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 or null

Inventory items and quantities within the WRO

last_updated_datedatetime

Last date the receiving order was updated

package_typeenum

Allowed values:

purchase_order_numberstring or null

Purchase order number for a receiving order

statusenum

status_historylist of objects or null

The history of status changes for this receiving order

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error