Create Warehouse Receiving Order | ShipBob Developer API

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

{
  "box_labels_uri": "https://api.shipbob.com/1.0/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",
  "final_destination_fulfillment_center_id": 1,
  "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"
    }
  ]
}

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

Allowed values:

final_destination_fulfillment_center_idinteger or nullOptional>=1

Fulfillment center the inventory is routed to after it is received at fulfillment_center, such as a spoke site served by a receiving hub. Only allowed for certain fulfillment centers and merchants. Fees may apply when routing to it requires cross-region transportation.

purchase_order_numberstring or nullOptional

Purchase order number for this receiving order

Response

Created

box_labels_uristring or nullOptional

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

box_packaging_typeenumOptional

Allowed values:

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

final_destination_fulfillment_center_idinteger or nullOptional

Fulfillment center the inventory is routed to after it is received at fulfillment_center, when one was set on the receiving order. Null otherwise.

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

Allowed values:

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

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error