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: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"
}'

{
  "box_labels_uri": "https://api.shipbob.com/2026-01/receiving/1/labels",
  "box_packaging_type": "EverythingInOneBox",
  "expected_arrival_date": "2019-08-24T14:15:22+00:00",
  "external_sync_timestamp": "2019-08-24T14:15:22+00:00",
  "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:22+00:00",
  "inventory_quantities": [
    {
      "expected_quantity": 0,
      "inventory_id": 0,
      "received_quantity": 0,
      "sku": "string",
      "stowed_quantity": 0
    }
  ],
  "last_updated_date": "2019-08-24T14:15:22+00:00",
  "package_type": "Package",
  "purchase_order_number": "string",
  "status": "Awaiting",
  "status_history": [
    {
      "id": 0,
      "status": "Processing",
      "timestamp": "2019-08-24T14:15:22+00:00"
    }
  ]
}

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

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. Requires a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z; a bare date such as 2026-08-05 is rejected.

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

purchase_order_numberstring or nullOptional

Purchase order number for this receiving order

Response

Success

box_labels_uristring or nullOptional

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

box_packaging_typeenumOptional

expected_arrival_datedatetimeOptional

Expected date that all packages will have arrived. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.

external_sync_timestampdatetime or nullOptional

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

fulfillment_centerobjectOptional

Information about a fulfillment center

idintegerOptional

Unique id of the warehouse receiving order

insert_datedatetimeOptional

Insert date of the receiving order. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.

inventory_quantitieslist of objects or nullOptional

Inventory items and quantities within the WRO

last_updated_datedatetimeOptional

Last date the receiving order was updated. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.

package_typeenumOptional

purchase_order_numberstring or nullOptional

Purchase order number for a receiving order

statusenumOptional

status_historylist of objects or nullOptional

The history of status changes for this receiving order

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error