ship-bob

name

ship-bob

description

ShipBob is a comprehensive e-commerce fulfillment and logistics platform that manages order processing, inventory distribution across 60+ global warehouses, and two-day shipping with built-in analytics and customization—enabling brands to scale operations like Amazon’s logistics network. Read and write ShipBob data through One: shipments, products, orders, inventorylevels, webhooksubscriptions, returnorders and more, 68 actions with real parameter documentation. Use whenever the user asks to look something up in ShipBob, create or update a record there, or build code against the ShipBob API.

ShipBob through One

ShipBob is a comprehensive e-commerce fulfillment and logistics platform that manages order processing, inventory distribution across 60+ global warehouses, and two-day shipping with built-in analytics and customization—enabling brands to scale operations like Amazon’s logistics network.

One exposes ShipBob through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform ship-bob if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm ShipBob is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real ShipBob account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Shipments

Action	Method	Path	Action id
Get a Shipment	GET	/2026-01/shipment/{{shipmentId}}	conn_mod_def::GJ7DvAcv0TI::-4pJOsp2TzCSYo-7kfptmA
Get a Shipment by Order ID and Shipment ID	GET	/2026-01/order/{{orderId}}/shipment/{{shipmentId}}	conn_mod_def::GJ7DvBFeHyU::fOdLQXsWRiaNUbKyyfOL-g
Get a Shipment’s Timeline	GET	/2026-01/shipment/{{shipmentId}}/timeline	conn_mod_def::GJ7DvI2AD7A::ct52XceiSgyQW48sx64rKA
List All Shipments for an Order	GET	/2026-01/order/{{orderId}}/shipment	conn_mod_def::GJ7DusUmFzE::LjMsqPOHTeeaKEcJTQg4TA
Batch Cancel Shipments	POST	/2026-01/shipment:batchCancel	conn_mod_def::GJ7DuaoUHDI::0kKJysB0QXOW126kjoueew
Cancel a Shipment	POST	/2026-01/shipment/{{shipmentId}}:cancel	conn_mod_def::GJ7DuY8xumc::HcuU-nGdQIeLs7Znphko0g
Cancel a Shipment for an Order	POST	/2026-01/order/{{orderId}}/shipment/{{shipmentId}}:cancel	conn_mod_def::GJ7DuZvfyu0::f83d1pR1TAKUWp86cAti-Q
Mark Tracking Uploaded for Multiple Shipments	POST	/2026-01/shipment:batchUpdateTrackingUpload	conn_mod_def::GJ7DvJHtKnY::7FXw03EeS8OYVuU_jtX-GA
Simulate a Shipment (Sandbox Only)	POST	/2026-01/simulate/shipment	conn_mod_def::GJ7DwOjRFzI::8JfFO76XSiyK4htOukUmPw

Products

Action	Method	Path	Action id
Get a Product	GET	/2026-01/product/{{productId}}	conn_mod_def::GJ7DvZaQcgc::30__igQIS9GJniFHdjrQhw
List Products	GET	/2026-01/product	conn_mod_def::GJ7Dvli6MIo::dyXbw_94TW-DIiuqjNoCSA
Add Variants to a Product	POST	/2026-01/product/{{productId}}/variants	conn_mod_def::GJ7DvIz6xFA::xTfaVOnVRZirPX8JYQGYtg
Create Product	POST	/2026-01/product	conn_mod_def::GJ7DvStTFIs::kyKl-DWXQJ-H4_3WvCN0ug
Delete a Product Bundle	DELETE	/2026-01/product/{{productId}}	conn_mod_def::GJ7DvYcud1o::2sNuTOXAT1SwHzHG49ax4Q
Move Variants Between Products (Target Product)	POST	/2026-01/product/{{productId}}:moveVariants	conn_mod_def::GJ7Dvun3ytY::awMRSqlLQV6BRJ8B1PtpOg
Move Variants to a New Product	POST	/2026-01/product:moveVariants	conn_mod_def::GJ7Dvtk_Ntw::zLlPsFhKSg-h9bFKvbONEg
Update a Product	PATCH	/2026-01/product/{{productId}}	conn_mod_def::GJ7DvuW-LfU::Bxmzwmn0S96DXEgyiF2ISQ
Update a Product’s Variants	PATCH	/2026-01/product/{{productId}}/variants	conn_mod_def::GJ7Dvtxjx7k::pSrlOrRfTKiPtmpNUTQlhA

Orders

Action	Method	Path	Action id
Get an Order	GET	/2026-01/order/{{orderId}}	conn_mod_def::GJ7Duq4TGlU::ZSJMAeR2RhaHiw6AJiRtgQ
Get an Order’s Store Order JSON Data	GET	/2026-01/order/{{orderId}}/store-order-json	conn_mod_def::GJ7Duq_g5C4::vk39oy3aShiGs7x9wDF7yA
List Orders	GET	/2026-01/order	conn_mod_def::GJ7Du2SOsAA::-39pURptRUSw6Oa6mk1tvw
Cancel an Order (and Associated Shipments)	POST	/2026-01/order/{{orderId}}:cancel	conn_mod_def::GJ7DujROyGE::pm_9mTbhSeWzkl8_hPkcQg
Create Order	POST	/2026-01/order	conn_mod_def::GJ7Duafes1w::fFUNoKMsSO6TkfuRqFVQ5g
Estimate Fulfillment Cost For Order	POST	/2026-01/order:estimate	conn_mod_def::GJ7DurTUku4::UukUB293QYanemMcwt7KUA

InventoryLevels

Action	Method	Path	Action id
Get All Inventory Levels	GET	/2026-01/inventory-level	conn_mod_def::GJ7DuERgcJ8::fQmMpx6RTKWrV7f2vXDbpw
Get Inventory Levels for an Inventory Item	GET	/2026-01/inventory-level/{{inventoryId}}	conn_mod_def::GJ7DuQFXjR4::fyuNRIKPQ8uKUCRFJCgT8g
Get Inventory Levels Grouped by Fulfillment Center for an Inventory Item	GET	/2026-01/inventory-level/{{inventoryId}}/locations	conn_mod_def::GJ7DuQcnZ6o::nSjXovmhTbCtRQDhdVsWuQ
Get Inventory Levels Grouped by Fulfillment Center Locations	GET	/2026-01/inventory-level/locations	conn_mod_def::GJ7DuDh_iX4::3H8XE9F9SKueRnJaNFYjWw
Get Inventory Levels Grouped by Lot for an Inventory Item	GET	/2026-01/inventory-level/{{inventoryId}}/lots	conn_mod_def::GJ7DuQgnA1s::fdf2seu0T5GcJXcKxgatlA

WebhookSubscriptions

Action	Method	Path	Action id
List Webhook Subscriptions	GET	/2026-01/webhook	conn_mod_def::GJ7Dwatgkds::7i9q8L3xTyu0yDFXkEJ7bg
Create Webhook Subscription	POST	/2026-01/webhook	conn_mod_def::GJ7DwaQ8lkU::8UUhB_pOQv6kza_dDqMoVA
Delete a Webhook Subscription	DELETE	/2026-01/webhook/{{id}}	conn_mod_def::GJ7DwjMHMGc::ckyMNtHHTIKUbgXFIAYiDg

ReturnOrders

Action	Method	Path	Action id
Get a Return Order	GET	/2026-01/return/{{id}}	conn_mod_def::GJ7DwOxIlTc::7B9eUFmDRtOepjHQ_Z09KA
Get Return Orders	GET	/2026-01/return	conn_mod_def::GJ7DwS2rixQ::BzJfRmZVQp2Nby4I3EPG8g
Cancel a Return Order	POST	/2026-01/return/{{id}}:cancel	conn_mod_def::GJ7DwDH9eG4::mGPa9LaBR_qHH5KthA9tRg

Variants

Action	Method	Path	Action id
Convert a Variant to a Bundle	POST	/2026-01/variant/{{variantId}}:convertToBundle	conn_mod_def::GJ7DvKQux-A::OkxEWsc2Q_O6p3jKw_E6-Q
Merge Variants Into a Target Variant	POST	/2026-01/variant/{{variantId}}	conn_mod_def::GJ7DviHl0-Y::8m-iXL0VSQKoI9i9Q8DziA

WarehouseReceivingOrders

Action	Method	Path	Action id
List Warehouse Receiving Orders	GET	/2026-01/receiving	conn_mod_def::GJ7Dv4Ax5jo::mnIxJB5wSL6gciNACc0NUw
Cancel a Warehouse Receiving Order	POST	/2026-01/receiving/{{id}}	conn_mod_def::GJ7Dvszhze4::urXjUWg9Q_GDtUe_FPI9Qg

Receiving

Action	Method	Path	Action id
Get a Warehouse Receiving Order	GET	/2026-01/receiving/{{id}}	conn_mod_def::GJ7Dv2jRaVw::QLSr_xSBS3-Ci6-PXR8vhg
Create Warehouse Receiving Order	POST	/2026-01/receiving	conn_mod_def::GJ7Dv2aWkTk::QfKuUZCtQfWNR5BWKVWxKg

Returns

Action	Method	Path	Action id
Create Return Order	POST	/2026-01/return	conn_mod_def::GJ7DwDgN8yw::NBr2L0OMRDuGLVTFPFE0dQ
Edit a Return Order	PUT	/2026-01/return/{{id}}	conn_mod_def::GJ7DwOX0Sf4::BvVoSlmjRQicqqDi5iZfZg

Taxonomy

Action	Method	Path	Action id
Get a Taxonomy Node’s Parent	GET	/2026-01/taxonomy/{{id}}/parent	conn_mod_def::GJ7DvhA2AmE::ak79TIQCQCiSThYgTdMMRw
Get Taxonomy Node by ID	GET	/2026-01/taxonomy/{{id}}	conn_mod_def::GJ7DviRd6Fs::Pdw-MvcIQj2UV40ekKEzDw

ShipmentLogs

Action	Method	Path	Action id
Get a Shipment's Logs	GET	/2026-01/shipment/{{shipmentId}}/logs	conn_mod_def::GJ7Du9tfmEs::lEN2zn9GSDqtuMdHGQqU7g
Get Shipment Logs for an Order’s Shipment	GET	/2026-01/order/{{orderId}}/shipment/{{shipmentId}}/logs	conn_mod_def::GJ7Du9uHjyw::sUCFN0CeRMSw7KRVHaNcRQ

Inventories

Action	Method	Path	Action id
Get All Inventories	GET	/2026-01/inventory	conn_mod_def::GJ7DuDfKWC8::YY04j2tSQTOyXgS63qSDWA

Taxonomies

Action	Method	Path	Action id
Get Taxonomies	GET	/2026-01/taxonomy	conn_mod_def::GJ7DviRCYbg::bfylYyWoRzi17aRRIKpwMQ

ReceivingDistributions

Action	Method	Path	Action id
Get Inventory Distributions by WRO ID	GET	/2026-01/receiving/{{id}}/distributions	conn_mod_def::GJ7Dv5mF_NQ::SZROeaaZQT6PY1rvvdL4Ew

ReceivingOrderLabels

Action	Method	Path	Action id
Get a Warehouse Receiving Order’s Box Labels (PDF)	GET	/2026-01/receiving/{{id}}/labels	conn_mod_def::GJ7DwBVmfWQ::XBPwuYBUQyyQA_e8nHSc5g

ReceivingOrders

Action	Method	Path	Action id
Set External Sync Flag for Warehouse Receiving Orders (WROs)	POST	/2026-01/receiving:setExternalSync	conn_mod_def::GJ7DwHNh2Ik::mo7H4jG_SPOOIvDVqKLLcg

ReceivingOrderBoxes

Action	Method	Path	Action id
Get Boxes for a Warehouse Receiving Order	GET	/2026-01/receiving/{{id}}/boxes	conn_mod_def::GJ7DwCcrvEM::V1b9XrbaR02Z1BPoTohVpA

SandboxSimulations

Action	Method	Path	Action id
Get a Sandbox Simulation’s Status	GET	/2026-01/simulate/status/{{simulationId}}	conn_mod_def::GJ7DwO13900::mosblhPzTNyEKJcFdKT2zg

InventoryHistoryEvents

Action	Method	Path	Action id
Query Inventory History Events	POST	/2026-01/inventory/history:query	conn_mod_def::GJ7DuQ2icEM::vHUCekL0RKu6z4cQ3tuyKA

Locations

Action	Method	Path	Action id
List Locations	GET	/2026-01/location	conn_mod_def::GJ7DuPF4BDA::6-4AxXhDTCeE-_kv3JHGpQ

TransactionFees

Action	Method	Path	Action id
List Transaction Fees	GET	/2026-01/transaction-fees	conn_mod_def::GJ7Dt3rXGu0::N_2iuAtjSqGUuHj83JZAbg

Invoices

Action	Method	Path	Action id
List Invoices	GET	/2026-01/invoices	conn_mod_def::GJ7Dt6A3OFE::emX5u9EwRBGGoGrCpI7bQg

InvoiceTransactions

Action	Method	Path	Action id
Get Transactions for an Invoice	GET	/2026-01/invoices/{{invoiceId}}/transactions	conn_mod_def::GJ7Dt6mLkhQ::n5ZWIjWURW2BwExH1Kp_tQ

Inventory

Action	Method	Path	Action id
Get an Inventory Item	GET	/2026-01/inventory/{{inventoryId}}	conn_mod_def::GJ7DuB72zcc::siNX1uDUQpq0UbW41YUVXA

InventoryLevelsLots

Action	Method	Path	Action id
Get All Inventory Levels Grouped By Lot	GET	/2026-01/inventory-level/lots	conn_mod_def::GJ7DuG2iRik::jKqFNr2eR2m3yYLXO66heA

Transactions

Action	Method	Path	Action id
Search Transactions	POST	/2026-01/transactions:query	conn_mod_def::GJ7Dt6n8hjY::xG8iVQl8SxmEK4UwBYJd4g

ShippingMethods

Action	Method	Path	Action id
List Shipping Methods	GET	/2026-01/shipping-method	conn_mod_def::GJ7DvLKwBTk::j34WlKWJQdmz64pXKt7l7w

ProductVariants

Action	Method	Path	Action id
List a Product’s Variants	GET	/2026-01/product/{{productId}}/variants	conn_mod_def::GJ7DvSqDSOg::fxkuXv6pSwuYB116Cwv34w

PackagingRequirements

Action	Method	Path	Action id
List Packaging Requirements	GET	/2026-01/packaging-requirement	conn_mod_def::GJ7DvWHkR6M::1SpuEEfPRB2Ngl_Z91dlKA

Channels

Action	Method	Path	Action id
List Channels	GET	/2026-01/channel	conn_mod_def::GJ7Dt5N5_Rk::DEeUXZC7QcKA6sOt4_By1g

ShipmentTimelines

Action	Method	Path	Action id
Get a Shipment Status Timeline by Order ID and Shipment ID	GET	/2026-01/order/{{orderId}}/shipment/{{shipmentId}}/timeline	conn_mod_def::GJ7Du-hxPs8::UnkoZTFbRDKgRcwL0fR2GA

FulfillmentCenters

Action	Method	Path	Action id
List Fulfillment Centers	GET	/2026-01/fulfillment-center	conn_mod_def::GJ7Dv2Ogkcc::pMlOahPXS_GuNcXwlGtYKw

When a call fails

The error comes from ShipBob, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/ship-bob

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.