FAQ
Common questions
At ShipBob you must create “channel product” records in our system in order to create orders. This is so we always have a unique and immutable tie to the upstream system, which reduces the risk of line item errors and order duplication. You cannot create orders with inventory_ids or with products created from other sources. Please review our documentation:
There are 2 ways to create products for your convenience:
- Create the products via the Product POST. If you pass through a SKU that already exists in the ShipBob UI as the product’s “reference_id”, we will automatically merge that product to the existing inventory. Otherwise, the merchant will have to manually “merge” the items using our UI
- Create the products using both the
reference_idandnamefields in the line item field for the Order POST. We will auto-create any unrecognized products given bothreference_idandnameare provided when you send us orders. This replaces the products sync step described above. Similarly, we will auto-merge the items in the manner described above if appropriate.
PAT is for single merchants with full access, while OAuth 2.0 is for multi-user apps with granular permissions. (Learn more)
Check the X-RateLimit-Remaining header in API responses. (Learn more)
If there is an additional page you will see next-page in the header.
ShipBob inventory items uses ounces (oz) and this is reflected in our API. For reference, see in the Get an inventory item response.
ShipBob inventory items uses inches (in) and this is reflected in our API. For reference, see in the Get an inventory item response.
You can find the fulfillment centers you have access to by making a request to the GET FulfillmentCenter endpoint at api.shipbob.com/1.0/fulfillmentCenter. The response will return the locations (fulfillment centers and hubs) you have access to.
Here is a sample response:
[
{
"id": 228,
"name": "Moreno Valley (CA)",
"timezone": "Pacific Standard Time",
"address1": "28010 Eucalyptus Ave",
"address2": "Building #1",
"city": "Moreno Valley",
"state": "CA",
"country": "US",
"zip_code": "92555",
"phone_number": "8444744726",
"email": "[email protected]"
}
]
If you are using a ShipBob sandbox account make sure to update your request to sandbox-api.shipbob.com/1.0/fulfillmentCenter.