E-Commerce · Beta
ShipHero
API integration
Ship E-Commerce features without building the integration. Full ShipHero API access via Proxy and 200+ MCP-ready tools for AI agents — extend models and mappings to fit your product.
Built for specific customer use cases. Issues are resolved quickly.
Talk to usUse Cases
Why integrate with ShipHero
Common scenarios for SaaS companies building ShipHero integrations for their customers.
Embed omnichannel order routing for DTC brands
Order Management and headless commerce platforms can push orders from any storefront into ShipHero and sync fulfillment status back, letting merchants connect their warehouse without custom GraphQL work.
Automate 3PL billing reconciliation in accounting tools
Financial SaaS and ERP middleware can pull finalized ShipHero bills and ad-hoc charges to generate accurate accounts receivable in NetSuite, QuickBooks, or Xero on behalf of their 3PL customers.
Power returns platforms with warehouse-grade restocking
Returns and RMA SaaS products can create returns, generate shipping labels, and track line-item receipts in ShipHero to automate refunds and restock decisions the moment goods hit the dock.
Drive demand planning with live inventory snapshots
Forecasting and replenishment tools can poll inventory snapshots, cycle counts, inbound shipments, and purchase orders to recommend reorders and push draft POs back into the merchant's ShipHero account.
Launch warehouse analytics and gamification dashboards
Operations analytics SaaS can read picker and packer performance, picks per day, and labor data to build live leaderboards and bottleneck detection for warehouse floors running ShipHero.
What You Can Build
Ship these features with Truto + ShipHero
Concrete product features your team can ship faster by leveraging Truto’s ShipHero integration instead of building from scratch.
Two-way order and fulfillment sync
Create orders in ShipHero from any sales channel and listen for fulfillment status updates via webhooks to keep storefronts and ERPs in lockstep.
Wholesale and B2B freight workflows
Create wholesale orders, generate Bills of Lading, packing slips, packing layouts, and shipping labels so B2B marketplaces can hand buyers full compliance documents.
3PL billing and ad-hoc charge automation
Create and submit bills, attach ad-hoc charges for value-added labor, and fetch finalized invoices to push line items into downstream accounting systems.
Returns orchestration with line-item receipts
Create returns, attach documentation, update return status, and record received line items to drive refund and restock logic in your returns product.
Inventory intelligence and auto-replenishment
Trigger inventory snapshots, read warehouse products and lots, monitor inventory changes, and create purchase orders when stock dips below forecasted thresholds.
Warehouse workforce performance dashboards
Surface picker performance, packer performance, picks and packs per day, and labor jobs and units to power KPI dashboards and gamified leaderboards.
SuperAI
ShipHero AI agent tools
Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.
create_a_ship_hero_access_token
Get a ShipHero access token: POST /auth/refresh with the stored refresh token, or POST /auth/token with the username and password on first connect. The connector calls this on connect and once a day; you rarely need it directly. Required: refresh_token, or username and password (taken from the connected account, not from the caller).
list_all_ship_hero_account
Fetch account records matching the supplied arguments.
list_all_ship_hero_ad_hoc_charges
Fetch ad hoc charges matching the supplied arguments. Required: ids. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_ad_hoc_charge
Creates an ad hoc charge for a customer. When a bill is given, adds the charge to it. That bill must be a draft. Required: customer_account_id, name, description, occurred_at, labor_unit_id, unit_amount, rate. Send the AddBillAdHocChargeInput fields as the request body (ShipHero mutation bill_add_ad_hoc_charge).
update_a_ship_hero_ad_hoc_charge_by_id
Updates an ad hoc charge. Fails if the charge is on a bill that is not a draft. Required: id. The id is the adhoc_charge_id. Send the UpdateBillAdHocChargeInput fields as the request body (ShipHero mutation bill_update_ad_hoc_charge).
create_a_ship_hero_assembly_component
Adds one or more components to a product assembly. Required: assembly_sku, components. Send the AddAssemblyComponentsInput fields as the request body (ShipHero mutation assembly_add_components).
ship_hero_assembly_components_bulk_clear
Removes every component from a product assembly. Required: assembly_sku. Send the ClearAssemblyComponentsInput fields as the request body (ShipHero mutation assembly_clear_components).
ship_hero_assembly_components_bulk_delete
Removes one or more components from a product assembly. Required: assembly_sku, components. Send the RemoveAssemblyComponentsInput fields as the request body (ShipHero mutation assembly_remove_components).
ship_hero_assembly_components_bulk_update
Changes the quantity of one or more components in a product assembly. Required: assembly_sku, components. Send the UpdateAssemblyComponentsInput fields as the request body (ShipHero mutation assembly_update_components).
create_a_ship_hero_bill_recalculation
Recalculates a bill's charges as a new bill. Fails if the bill is finalized, deleted, or already recalculating. Required: id. Send the RecalculateBillInput fields as the request body (ShipHero mutation bill_recalculate).
get_single_ship_hero_bill_by_id
Fetch bill records matching the supplied arguments. Required: id.
list_all_ship_hero_bills
Fetch bills matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_bill
Creates a bill for a customer covering a date range and starts calculating its charges. The customer must have a billing profile. Required: customer_account_id, start_date, end_date. Send the CreateBillInput fields as the request body (ShipHero mutation bill_create).
delete_a_ship_hero_bill_by_id
Deletes a bill. Required: id. The id is the id. Send the DeleteBillInput fields as the request body (ShipHero mutation bill_delete).
ship_hero_bills_submit
Sends a finalized bill to the customer by email. The customer must have bill access, and each bill can be submitted only once. Required: id. Send the SubmitBillInput fields as the request body (ShipHero mutation bill_submit).
update_a_ship_hero_bill_by_id
Changes a bill's status to draft, finalized, or paid. Paid bills cannot be updated. Required: id, status. The id is the id. Send the UpdateBillInput fields as the request body (ShipHero mutation bill_update).
get_single_ship_hero_carrier_box_by_id
Fetch carrier box records matching the supplied arguments. Required: id. The id is the box_code.
list_all_ship_hero_carrier_boxes
Fetch carrier boxes matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
update_a_ship_hero_carrier_box_by_id
Updates the price or quantity on hand of a carrier box in a warehouse. Required: id, warehouse_id. The id is the box_code. Send the UpdateCarrierBoxInput fields as the request body (ShipHero mutation carrier_box_update).
get_single_ship_hero_custom_box_by_id
Fetch custom box records matching the supplied arguments. Required: id.
list_all_ship_hero_custom_boxes
Fetch custom boxes matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_custom_box
Creates a custom box for a warehouse with its dimensions, price, and quantity on hand. Required: name, warehouse_id, dimensions. Send the CreateCustomBoxInput fields as the request body (ShipHero mutation custom_box_create).
delete_a_ship_hero_custom_box_by_id
Deletes a custom box. Required: id. The id is the custom_box_id. Send the DeleteCustomBoxInput fields as the request body (ShipHero mutation custom_box_delete).
update_a_ship_hero_custom_box_by_id
Updates a custom box. Omitted fields keep their current values. Required: id. The id is the custom_box_id. Send the UpdateCustomBoxInput fields as the request body (ShipHero mutation custom_box_update).
create_a_ship_hero_cycle_count_recount
Creates a cycle count that recounts items flagged with discrepancies in an earlier count. Required: name, warehouse_id. Send the CreateRecountCycleCountInput fields as the request body (ShipHero mutation cycle_count_recount_create).
get_single_ship_hero_cycle_count_by_id
Fetch cycle count records matching the supplied arguments. Required: id.
list_all_ship_hero_cycle_counts
Fetch cycle counts matching the supplied arguments. Required: warehouse_id. The connector pages through all results (50 per page; nested lists show their first 10 records).
list_all_ship_hero_data_exports
Fetch data export files for the authenticated account. Required: export_types.
get_single_ship_hero_fulfillment_invoice_by_id
Fetch fulfillment invoice records matching the supplied arguments. Required: id.
list_all_ship_hero_fulfillment_invoices
Fetch fulfillment invoices matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_fulfillment_status
Creates a custom order fulfillment status for your account or a 3PL customer account. Required: name. Send the CreateOrderFulfillmentStatusInput fields as the request body (ShipHero mutation order_fulfillment_status_create).
list_all_ship_hero_inbound_shipment_images
Fetch inbound shipment images matching the supplied arguments. Required: inbound_shipment_id.
get_single_ship_hero_inbound_shipment_location_summary_by_id
Fetch inbound shipment location summary records matching the supplied arguments. Required: id. The id is the inbound_shipment_id.
get_single_ship_hero_inbound_shipment_summary_by_id
Fetch inbound shipment summary records matching the supplied arguments. Required: id. The id is the inbound_shipment_id.
get_single_ship_hero_inbound_shipment_by_id
Fetch inbound shipment records matching the supplied arguments. Required: id.
list_all_ship_hero_inbound_shipments
Fetch inbound shipments matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_inbound_shipment
Creates an inbound shipment for a warehouse, linked to purchase orders and a vendor, with carrier, dock, and truck schedule details. Required: warehouse_id. Send the CreateInboundShipmentInput fields as the request body (ShipHero mutation inbound_shipment_create).
update_a_ship_hero_inbound_shipment_by_id
Updates the warehouse, purchase orders, carrier, and truck details of an inbound shipment. Required: id, warehouse_id, purchase_orders_ids. The id is the inbound_shipment_id. Send the UpdateInboundShipmentInput fields as the request body (ShipHero mutation inbound_shipment_update).
create_a_ship_hero_inventory_addition
Adds on-hand quantity of a SKU to a warehouse location or license plate (LPN). Required: sku, warehouse_id, quantity. Send the UpdateInventoryInput fields as the request body (ShipHero mutation inventory_add).
list_all_ship_hero_inventory_changes
Fetch inventory changes matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_inventory_removal
Removes on-hand quantity of a SKU from a warehouse location or license plate (LPN). Required: sku, warehouse_id, quantity. Send the UpdateInventoryInput fields as the request body (ShipHero mutation inventory_remove).
create_a_ship_hero_inventory_replacement
Sets the on-hand quantity of a SKU in a warehouse location to an exact value. Required: sku, warehouse_id, quantity. Send the ReplaceInventoryInput fields as the request body (ShipHero mutation inventory_replace).
get_single_ship_hero_inventory_snapshot_by_id
Fetch inventory snapshot records matching the supplied arguments. Required: id. The id is the snapshot_id.
list_all_ship_hero_inventory_snapshots
Fetch inventory snapshots matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_inventory_snapshots_cancel
Cancels an inventory snapshot that is still being generated. Required: snapshot_id. Send the InventoryAbortSnapshotInput fields as the request body (ShipHero mutation inventory_abort_snapshot).
create_a_ship_hero_inventory_snapshot
Starts building a snapshot of inventory in the background. When it is ready, a notification is sent to the given email address or URL. Send the InventoryGenerateSnapshotInput fields as the request body (ShipHero mutation inventory_generate_snapshot).
create_a_ship_hero_inventory_subtraction
Same as inventory_remove. Removes on-hand quantity of a SKU from a warehouse location or LPN. Required: sku, warehouse_id, quantity. Send the UpdateInventoryInput fields as the request body (ShipHero mutation inventory_subtract).
list_all_ship_hero_inventory_sync_items
Fetch inventory sync items status matching the supplied arguments. Required: sync_id. The connector pages through all results (50 per page; nested lists show their first 10 records).
get_single_ship_hero_inventory_sync_by_id
Fetch inventory sync status matching the supplied arguments. Required: id.
list_all_ship_hero_inventory_syncs
Fetch inventory sync statuses matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_inventory_syncs_cancel
Cancels an inventory sync that is still pending or running. Required: sync_id. Send the AbortInventorySyncInput fields as the request body (ShipHero mutation inventory_sync_abort).
create_a_ship_hero_inventory_sync
Starts a background sync that updates inventory in a warehouse from a file at the given URL. Only one sync can be pending or running per account and warehouse. Required: url, warehouse_id. Send the InventorySyncInput fields as the request body (ShipHero mutation inventory_sync).
create_a_ship_hero_inventory_transfer
Moves a quantity of a SKU from one location or license plate (LPN) to another within the same warehouse. Required: sku, warehouse_id, quantity. Send the TransferInventoryInput fields as the request body (ShipHero mutation inventory_transfer).
create_a_ship_hero_item_cycle_count
Creates a cycle count for specific SKUs, picked by SKU list, vendor, client, or tag. Required: name, warehouse_id. Send the CreateItemsCycleCountInput fields as the request body (ShipHero mutation cycle_count_items_create).
list_all_ship_hero_item_locations
Fetch item locations matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_item_locations_bulk_delete
Removes product assignments from locations. Each assignment must have a quantity of 0. Required: ids. Send the DeleteItemLocationInput fields as the request body (ShipHero mutation item_location_delete).
ship_hero_kit_components_bulk_delete
Removes the given components from a kit. Required: sku, components. Send the RemoveKitComponentsInput fields as the request body (ShipHero mutation kit_remove_components).
create_a_ship_hero_kit
Adds components to an existing product and makes it a kit. Components already in the kit keep their current quantities. Required: sku, components. Send the BuildKitInput fields as the request body (ShipHero mutation kit_build).
delete_a_ship_hero_kit_by_id
Removes every component from a kit. Required: id. The id is the sku. Send the ClearKitInput fields as the request body (ShipHero mutation kit_clear).
list_all_ship_hero_labor_jobs
Returns a paginated list of top-level active jobs in a warehouse. Required: warehouse_id.
list_all_ship_hero_labor_units
Fetch labor units matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
list_all_ship_hero_labor_workers
Returns a paginated list of workers in a warehouse. Required: warehouse_id.
list_all_ship_hero_lakehero_data_exports
Fetch data export records matching the supplied arguments.
create_a_ship_hero_license_plate_number_move
Moves license plates (LPNs) to a location, or nests them inside or removes them from a parent LPN. Required: lpn_ids. Send the MoveLicensePlateNumbersInput fields as the request body (ShipHero mutation license_plate_numbers_move).
list_all_ship_hero_license_plate_numbers
Fetch paginated license plate numbers using exact filters. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_license_plate_number
Creates 1 to 1300 license plates (LPNs) in a warehouse, with generated or provided barcodes. Required: warehouse_id, container_type, quantity. Send the CreateLicensePlateNumbersInput fields as the request body (ShipHero mutation license_plate_numbers_create).
create_a_ship_hero_location_cycle_count
Creates a cycle count for all inventory in warehouse locations, picked by name prefix or location type. Required: name, warehouse_id. Send the CreateLocationsCycleCountInput fields as the request body (ShipHero mutation cycle_count_locations_create).
get_single_ship_hero_location_by_id
Fetch location records matching the supplied arguments. Required: id.
list_all_ship_hero_locations
Fetch locations matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_locations_bulk_create
Creates up to 1300 warehouse locations from a list of names or a naming pattern. Names that already exist are skipped, so it is safe to retry. Required: warehouse_id. Send the CreateLocationsBulkInput fields as the request body (ShipHero mutation location_bulk_create).
create_a_ship_hero_location
Creates a location in a warehouse. Required: warehouse_id, name, zone. Send the CreateLocationInput fields as the request body (ShipHero mutation location_create).
delete_a_ship_hero_location_by_id
Deletes a warehouse location. The location must not hold any products. Required: id. The id is the location_id. Send the DeleteLocationInput fields as the request body (ShipHero mutation location_delete).
update_a_ship_hero_location_by_id
Updates an existing warehouse location, such as its zone, type, pickable or sellable flags, or size. Required: id. The id is the location_id. Send the UpdateLocationInput fields as the request body (ShipHero mutation location_update).
list_all_ship_hero_lots
Fetch expiration lots matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_lots_assign
Assigns a lot to a warehouse location. Units already in the location without a lot join this lot. Fails if a different lot is already in the location. Required: lot_id, location_id. Send the AssignLotToLocationInput fields as the request body (ShipHero mutation lot_assign_to_location).
create_a_ship_hero_lot
Creates a lot for a product, with an optional expiration date. Required: name, sku. Send the CreateLotInput fields as the request body (ShipHero mutation lot_create).
delete_a_ship_hero_lot_by_id
Deletes a lot. Required: id. The id is the lot_id. Send the DeleteLotInput fields as the request body (ShipHero mutation lot_delete).
update_a_ship_hero_lot_by_id
Updates a lot, such as its name, expiration date, or whether it is active. Required: id. The id is the lot_id. Send the UpdateLotInput fields as the request body (ShipHero mutation lot_update).
ship_hero_lots_bulk_update
Activates or deactivates several lots at once. Required: lots_ids. Send the UpdateLotsInput fields as the request body (ShipHero mutation lots_update).
list_all_ship_hero_me
Fetch the authenticated public API user and account context.
list_all_ship_hero_mergeable_orders
Fetch mergeable orders matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_order_attachment
Adds a file attachment to an order. Required: order_id, url. Send the OrderAddAttachmentInput fields as the request body (ShipHero mutation order_add_attachment).
update_a_ship_hero_order_fulfillment_status_by_id
Sets the fulfillment status of an order. cancel_on_platform and void_on_platform are only allowed when the status is "canceled". Required: id, fulfillment_status. The id is the order_id. Send the UpdateOrderFulfillmentStatusInput fields as the request body (ShipHero mutation order_update_fulfillment_status).
list_all_ship_hero_order_history
Fetch order history records matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_order_history
Adds a note to the history of an order. The source defaults to "public-api" when omitted. Required: order_id. Send the AddHistoryInput fields as the request body (ShipHero mutation order_add_history_entry).
update_a_ship_hero_order_hold_by_id
Sets or clears the payment, operator, fraud, address, and client holds on an order. Required: id. The id is the order_id. Send the UpdateOrderHoldsInput fields as the request body (ShipHero mutation order_update_holds).
update_a_ship_hero_order_line_item_skus_by_id
Replaces the product on an order line item by changing its SKU from old_sku to new_sku. Required: id, old_sku, new_sku. The id is the order_id. Send the SetLineItemSkuInput fields as the request body (ShipHero mutation order_set_line_item_sku).
create_a_ship_hero_order_line_item
Adds line items to an existing order. Required: order_id, line_items. Send the AddLineItemsInput fields as the request body (ShipHero mutation order_add_line_items).
ship_hero_order_line_items_bulk_delete
Removes line items from an order. Required: order_id. Send the RemoveLineItemsInput fields as the request body (ShipHero mutation order_remove_line_items).
ship_hero_order_line_items_bulk_update
Updates existing line items on an order. Required: order_id. Send the UpdateLineItemsInput fields as the request body (ShipHero mutation order_update_line_items).
delete_a_ship_hero_order_tag_by_id
Removes all tags from an order. Required: id. The id is the order_id. Send the UpdateOrderInputBase fields as the request body (ShipHero mutation order_clear_tags).
update_a_ship_hero_order_tag_by_id
Replaces all tags on an order with the given list. Required: id. The id is the order_id. Send the UpdateTagsInput fields as the request body (ShipHero mutation order_update_tags).
update_a_ship_hero_order_warehouse_by_id
Moves all line items of an order to another warehouse and clears its pending shipments. Required: id, warehouse_id. The id is the order_id. Send the ChangeOrderWarehouseInput fields as the request body (ShipHero mutation order_change_warehouse).
get_single_ship_hero_order_by_id
Fetch order records matching the supplied arguments. Required: id.
list_all_ship_hero_orders
Fetch orders matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_orders_tag
Adds tags to an order and keeps its existing tags. Required: order_id. Send the UpdateTagsInput fields as the request body (ShipHero mutation order_add_tags).
ship_hero_orders_bulk_tag
Adds tags to up to 50 orders at once. Send the BulkUpdateTagsInput fields as the request body (ShipHero mutation order_bulk_add_tags).
ship_hero_orders_bulk_untag
Removes tags from up to 50 orders at once. Send the BulkUpdateTagsInput fields as the request body (ShipHero mutation order_bulk_remove_tags).
ship_hero_orders_cancel
Cancels an order and, by default, also cancels it on the connected sales platform. Orders with valid shipping labels can only be canceled with force. Required: order_id. Send the CancelOrderInput fields as the request body (ShipHero mutation order_cancel).
create_a_ship_hero_order
Creates an order with at least one line item, for your account or a 3PL customer account. Required: shipping_address. Send the CreateOrderInput fields as the request body (ShipHero mutation order_create).
ship_hero_orders_complete
Fulfills an order by creating a shipment with the given packages from a tote. Can notify the customer about the shipment. Required: order_id, tote_id, packages. Send the FulfillOrderInput fields as the request body (ShipHero mutation order_fulfill).
ship_hero_orders_merge
Merges one or more sub orders into a master order. Required: master_order_id, sub_order_ids. Send the MergeOrdersInput fields as the request body (ShipHero mutation order_merge).
ship_hero_orders_bulk_unmerge
Unmerges orders from a merged group. Including the master order unmerges the whole group. Required: order_ids. Send the UnmergeOrdersInput fields as the request body (ShipHero mutation order_unmerge).
update_a_ship_hero_order_by_id
Updates order details such as addresses, totals, shipping lines, and allocation priority. Required: id. The id is the order_id. Send the UpdateOrderInput fields as the request body (ShipHero mutation order_update).
list_all_ship_hero_packer_performance
Returns a paginated list of packer performance stats for a warehouse. All duration fields are returned in seconds. Results are ordered by score DESC by default. Required: warehouse_id.
list_all_ship_hero_packs_per_day
Gets the details of each shipment's package between the specified dates. Results are sorted by date, warehouse, and user, but they can be filtered by warehouse_id if you are only interested in packages from a particular warehouse. The sorting can be overridden by specifying any other field or list of fields from the output type. The connector pages through all results (50 per page; nested lists show their first 10 records).
list_all_ship_hero_picker_performance
Returns a paginated list of picker performance stats for a warehouse. All duration fields are returned in seconds. Results are ordered by score DESC by default. Required: warehouse_id.
list_all_ship_hero_picks_per_day
Gets the details of each line item picked between the specified dates. Results are sorted by date, warehouse, and user, but they can be filtered by warehouse_id if you are only interested in picks from a particular warehouse. The sorting can be overridden by specifying any other field or list of fields from the output type. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_product_images_bulk_delete
Removes the image with the given URL from a product. Reports whether a matching image was found. Required: sku, src. Send the DeleteProductImageInput fields as the request body (ShipHero mutation product_delete_image).
list_all_ship_hero_product_stores
Stores the product SKU is connected to, with the IDs to use in product_update manage_inventory_stores and whether inventory push can be managed on each. Required: sku. The connector pages through all results (50 per page; nested lists show their first 10 records).
get_single_ship_hero_product_by_id
Fetch product records matching the supplied arguments. Required: id.
list_all_ship_hero_products
Fetch products matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_product
Creates a product and adds it to each of the given warehouses. Required: name, sku, warehouse_products. Send the CreateProductInput fields as the request body (ShipHero mutation product_create).
delete_a_ship_hero_product_by_id
Deletes a product and removes it from every warehouse. Required: id. The id is the sku. Send the DeleteProductInput fields as the request body (ShipHero mutation product_delete).
update_a_ship_hero_product_by_id
Updates a product's details, such as name, dimensions, tags, images, vendors, and cases. Required: id. The id is the sku. Send the UpdateProductInput fields as the request body (ShipHero mutation product_update).
create_a_ship_hero_purchase_order_attachment
Adds an attachment to a purchase order. Required: po_id, url. Send the AddPurchaseOrderAttachmentInput fields as the request body (ShipHero mutation purchase_order_add_attachment).
update_a_ship_hero_purchase_order_fulfillment_status_by_id
Sets the fulfillment status of a purchase order. Setting closed or canceled closes or cancels it. Required: id, status. The id is the po_id. Send the SetPurchaseOrderFulfillmentStatusInput fields as the request body (ShipHero mutation purchase_order_set_fulfillment_status).
get_single_ship_hero_purchase_order_by_id
Fetch purchase order records matching the supplied arguments. Required: id.
list_all_ship_hero_purchase_orders
Fetch purchase orders matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_purchase_orders_cancel
Cancels a purchase order. Required: po_id. Send the CancelPurchaseOrderInput fields as the request body (ShipHero mutation purchase_order_cancel).
ship_hero_purchase_orders_close
Closes a purchase order. Required: po_id. Send the ClosePurchaseOrderInput fields as the request body (ShipHero mutation purchase_order_close).
create_a_ship_hero_purchase_order
Creates a purchase order. Required: po_number, subtotal, shipping_price, total_price, warehouse_id, line_items. Send the CreatePurchaseOrderInput fields as the request body (ShipHero mutation purchase_order_create).
update_a_ship_hero_purchase_order_by_id
Updates a purchase order. Required: id. The id is the po_id. Send the UpdatePurchaseOrderInput fields as the request body (ShipHero mutation purchase_order_update).
list_all_ship_hero_recurring_data_exports
Fetch recurring data export records matching the supplied arguments.
create_a_ship_hero_return_attachment
Adds a file attachment to a return or to one of its items. Required: return_id, url. Send the AddReturnAttachmentInput fields as the request body (ShipHero mutation return_add_attachment).
get_single_ship_hero_return_exchange_by_id
Fetch return exchange records matching the supplied arguments. Required: id.
create_a_ship_hero_return_exchange
Creates an exchange on a return, which creates a new order for the replacement items. Required: return_id, exchange_items. Send the CreateReturnExchangeInput fields as the request body (ShipHero mutation return_create_exchange).
create_a_ship_hero_return_line_item_receipt
Receives a return line item into a warehouse and can restock part of it into a bin. Required: return_id, return_line_item_id, quantity_received, warehouse_id. Send the ReceiveReturnLineItemInput fields as the request body (ShipHero mutation return_receive_line_item).
update_a_ship_hero_return_status_by_id
Updates the status of a return. Required: id, status. The id is the return_id. Send the UpdateReturnStatusInput fields as the request body (ShipHero mutation return_update_status).
get_single_ship_hero_return_by_id
Fetch return records matching the supplied arguments. Required: id.
list_all_ship_hero_returns
Fetch returns matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_return
Creates a return for an order. Can generate a return label and email it to the customer. Required: order_id, warehouse_id, return_reason, label_type, label_cost, address, dimensions, shipping_carrier, shipping_method, line_items. Send the CreateReturnInput fields as the request body (ShipHero mutation return_create).
get_single_ship_hero_shipment_by_id
Fetch shipment records matching the supplied arguments. Required: id.
list_all_ship_hero_shipments
Fetch shipments matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_shipment
Creates a shipment for an order, with optional shipping labels. Required: order_id, warehouse_id, address, line_items. Send the CreateShipmentInput fields as the request body (ShipHero mutation shipment_create).
create_a_ship_hero_shipping_container_barcode_label
Generates barcode label PDFs for up to 100 shipping containers. Returns one PDF per container or one combined document. Required: shipping_container_ids. Send the PrintShippingContainerBarcodeLabelsInput fields as the request body (ShipHero mutation shipping_container_print_barcode_labels).
get_single_ship_hero_shipping_container_by_id
Fetch shipping container records matching the supplied arguments. Required: id.
list_all_ship_hero_shipping_containers
Fetch shipping containers matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_shipping_containers_attach
Adds a shipping label to a shipping container, identified by its ID or barcode. Required: shipping_label_id. Send the AddShippingLabelToShippingContainerInput fields as the request body (ShipHero mutation shipping_container_add_shipping_label).
create_a_ship_hero_shipping_container
Creates 1 to 100 shipping containers for a carrier and its shipping methods in a warehouse. Required: carrier. Send the CreateShippingContainerInput fields as the request body (ShipHero mutation shipping_container_create).
ship_hero_shipping_containers_bulk_delete
Deletes up to 100 shipping containers that have not shipped yet. Required: shipping_container_ids. Send the DeleteShippingContainerInput fields as the request body (ShipHero mutation shipping_container_delete).
ship_hero_shipping_containers_detach
Removes a shipping label from a shipping container, identified by its ID or barcode. Required: shipping_label_id. Send the RemoveShippingLabelFromShippingContainerInput fields as the request body (ShipHero mutation shipping_container_remove_shipping_label).
create_a_ship_hero_shipping_label
Creates a shipping label for a shipment. A shipment line item can belong to only one label, unless that label was voided. Required: carrier, shipping_name, shipping_method, cost, address, dimensions, label, line_item_ids, shipment_id. Send the CreateShippingLabelInput fields as the request body (ShipHero mutation shipment_create_shipping_label).
get_single_ship_hero_shipping_plan_by_id
Fetch shipping plan records matching the supplied arguments. Required: id.
create_a_ship_hero_shipping_plan
Creates a shipping plan and starts printing its labels. Only ShipHero Fulfillment accounts and warehouses can use it, and all products must already exist. Required: warehouse_id, line_items. Send the CreateShippingPlanInput fields as the request body (ShipHero mutation shipping_plan_create).
list_all_ship_hero_tote_history
Fetch tote history records matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_tote_location_transfer
Moves all current picks in a tote into a location. The tote and location must be in the same warehouse. Required: tote_id, location_id. Send the TransferToteToLocationInput fields as the request body (ShipHero mutation tote_transfer_to_location).
get_single_ship_hero_tote_by_id
Returns information about a tote. If barcode is set, but warehouse_id is not, it will default to the assigned warehouse id. If no tote is found with that barcode on the specified warehouse, it will return the next tote with the same barcode on any warehouse. It is recommended to use the id field to avoid ambiguity. Required: id.
list_all_ship_hero_totes
Fetch totes matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_totes_reset
Removes all current picks from a tote and puts them back in the locations they were picked from. Required: tote_id. Send the ClearToteInput fields as the request body (ShipHero mutation tote_clear).
create_a_ship_hero_tote
Creates a tote in a warehouse. Can also generate a barcode PDF for it. Required: warehouse_id. Send the CreateToteInput fields as the request body (ShipHero mutation tote_create).
delete_a_ship_hero_tote_by_id
Deletes a tote. Fails if the tote still has current picks. Required: id. The id is the tote_id. Send the DeleteToteInput fields as the request body (ShipHero mutation tote_delete).
update_a_ship_hero_tote_by_id
Renames a tote and can change whether it is used as a shipping box. Required: id, name. The id is the tote_id. Send the UpdateToteInput fields as the request body (ShipHero mutation tote_update).
list_all_ship_hero_user_quota
User quota for this user quota orders.
get_single_ship_hero_user_by_id
Fetch user records matching the supplied arguments. Required: id.
list_all_ship_hero_users
Fetch users matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
update_a_ship_hero_user_by_id
Updates a user's profile, pay details, and picking defaults such as default warehouse and order status. Required: id. The id is the user_id. Send the UpdateUserInput fields as the request body (ShipHero mutation user_update).
create_a_ship_hero_vendor_product
Adds a product to a vendor. Required: vendor_id, sku. Send the AddProductToVendorInput fields as the request body (ShipHero mutation vendor_add_product).
ship_hero_vendor_products_bulk_delete
Removes a product from a vendor. Required: vendor_id, sku. Send the RemoveProductFromVendorInput fields as the request body (ShipHero mutation vendor_remove_product).
list_all_ship_hero_vendors
Fetch vendors matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_vendor
Creates a vendor. Required: name, email. Send the CreateVendorInput fields as the request body (ShipHero mutation vendor_create).
delete_a_ship_hero_vendor_by_id
Deletes a vendor. Required: id. The id is the vendor_id. Send the DeleteVendorInput fields as the request body (ShipHero mutation vendor_delete).
list_all_ship_hero_warehouse_products
Fetch warehouse products matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_warehouse_product
Adds an existing product to a warehouse so it can hold inventory there. Required: sku, warehouse_id. Send the AddProductToWarehouseInput fields as the request body (ShipHero mutation product_add_to_warehouse).
ship_hero_warehouse_products_bulk_delete
Removes a product from a single warehouse. Required: sku, warehouse_id. Send the DeleteWarehouseProductInput fields as the request body (ShipHero mutation warehouse_product_delete).
ship_hero_warehouse_products_bulk_update
Updates a product's settings in a single warehouse, such as price, value, bins, and replenishment levels. Required: sku, warehouse_id. Send the UpdateWarehouseProductInput fields as the request body (ShipHero mutation warehouse_product_update).
create_a_ship_hero_warehouse_profile
Creates a profile for an existing warehouse with its own invoice and label addresses and invoice settings. Downloads the invoice logo from the URL given. Required: warehouse_id, profile, invoice_address, label_address. Send the WarehouseProfileCreateInput fields as the request body (ShipHero mutation warehouse_profile_create).
list_all_ship_hero_webhook_call_logs
Returns customer webhook call logs. date_from and date_to are UTC datetimes. If date_to is omitted it defaults to the current UTC time; if date_from is omitted it defaults to one hour before date_to. The maximum allowed period is one week. Required: webhook_id.
list_all_ship_hero_webhooks
Fetch webhooks matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_webhook
Registers a webhook URL for a webhook name and shop. Fails if the webhook already exists or the URL is invalid or unreachable. Required: name, url. Send the CreateWebhookInput fields as the request body (ShipHero mutation webhook_create).
delete_a_ship_hero_webhook_by_id
Deletes a webhook by name. Pass shop_name when more than one shop has a webhook with that name. Required: id. The id is the name. Send the DeleteWebhookInput fields as the request body (ShipHero mutation webhook_delete).
ship_hero_webhooks_disable
Disables a webhook so it stops sending events. The webhook is kept and can be enabled again. Required: webhook_id. Send the DisableWebhookInput fields as the request body (ShipHero mutation webhook_disable).
ship_hero_webhooks_enable
Enables a webhook so it starts sending events. Required: webhook_id. Send the EnableWebhookInput fields as the request body (ShipHero mutation webhook_enable).
update_a_ship_hero_webhook_by_id
Changes the URL a webhook sends events to. Required: id, new_url. The id is the webhook_id. Send the UpdateUrlWebhookInput fields as the request body (ShipHero mutation webhook_update_url).
create_a_ship_hero_wholesale_order_bol_document
Generates the bill of lading (BOL) document for a wholesale order and returns its PDF URL. Required: order_id. Send the WholesaleOrderGenerateBOLInput fields as the request body (ShipHero mutation wholesale_order_generate_bol_document).
create_a_ship_hero_wholesale_order_label_print
Marks the shipping labels of a wholesale order as printed and returns one merged labels PDF. The order must be in ready_to_print, warehouse_completed, or fulfilled status. It moves to warehouse_completed once every package has a printed label. Required: order_id. Send the WholesaleOrderPrintLabelsInput fields as the request body (ShipHero mutation wholesale_order_print_labels).
create_a_ship_hero_wholesale_order_label
Generates carrier shipping labels for a wholesale order, and carton labels when requested. The order must have exactly one pending shipment. Required: order_id. Send the WholesaleOrderGenerateLabelsInput fields as the request body (ShipHero mutation wholesale_order_generate_labels).
update_a_ship_hero_wholesale_order_outbound_schedule_by_id
Updates the outbound progress and pickup date of a wholesale order. Fulfilled orders can't be edited. Required: id. The id is the order_id. Send the WholesaleOrderEditOutboundScheduleInput fields as the request body (ShipHero mutation wholesale_order_edit_outbound_schedule).
create_a_ship_hero_wholesale_order_packing_layout
Imports the packing layout of a wholesale order: pallets, packages, and case packs with their line items. The order must not have a packing layout yet, and line item quantities must match the order. Freight orders must have only pallets at the top level, and courier orders cannot contain pallets. Kits broken into components must be packed using their components, not the kit itself. Required: order_id, packing_data. Send the WholesaleOrderImportPackingLayoutInput fields as the request body (ShipHero mutation wholesale_order_import_packing_layout).
create_a_ship_hero_wholesale_order_packing_list
Generates the packing list for a wholesale order and returns its URL. It is also sent to print unless printing is skipped. Required: order_id. Send the WholesaleOrderPrintPackingListInput fields as the request body (ShipHero mutation wholesale_order_print_packing_list).
create_a_ship_hero_wholesale_order_packing_slip
Generates the packing slip PDF for a wholesale order and returns its URL. The order must be in a status that allows packing slips. Required: order_id. Send the WholesaleOrderPrintPackingSlipInput fields as the request body (ShipHero mutation wholesale_order_print_packing_slip).
create_a_ship_hero_wholesale_order_packing
Marks a wholesale order as packed. The order must be in packing status, and it stays there if any allocated items are still unpacked. Required: order_id. Send the WholesaleOrderMarkAsPackedInput fields as the request body (ShipHero mutation wholesale_order_mark_as_packed).
update_a_ship_hero_wholesale_order_picking_flow_by_id
Sets the picking flow of a wholesale order. Required: id. The id is the order_id. Send the UpdateWholesaleOrderPickingFlowInput fields as the request body (ShipHero mutation wholesale_order_update_picking_flow).
create_a_ship_hero_wholesale_order_picking_sheet
Generates the manual picking sheet for a wholesale order and returns its URL. Required: order_id. Send the WholesaleOrderPrintManualPickingSheetInput fields as the request body (ShipHero mutation wholesale_order_print_manual_picking_sheet).
update_a_ship_hero_wholesale_order_staging_location_by_id
Sets the staging location for a wholesale order. Required: id, staging_location_id. The id is the order_id. Send the UpdateWholesaleOrderStagingLocationInput fields as the request body (ShipHero mutation wholesale_order_update_staging_location).
create_a_ship_hero_wholesale_order_staging_transfer
Moves the picked items of a wholesale order to staging. The order must have exactly one pending shipment. Required: order_id. Send the UpdateWholesaleOrderInputBase fields as the request body (ShipHero mutation wholesale_order_transfer_picks_to_staging).
get_single_ship_hero_wholesale_order_by_id
Fetch wholesale order records matching the supplied arguments. Required: id.
list_all_ship_hero_wholesale_orders
Fetch wholesale orders matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_wholesale_orders_assign
Allocates inventory from warehouse locations for picking a wholesale order, using the given location, lot, and stock sorting rules. The order must have exactly one pending shipment. Required: order_id. Send the WholesaleOrderAutoAllocateInput fields as the request body (ShipHero mutation wholesale_order_auto_allocate_for_picking).
create_a_ship_hero_wholesale_order
Creates a wholesale order from new order details, or from an existing order. Required: shipping_address. Send the CreateWholesaleOrderInput fields as the request body (ShipHero mutation wholesale_order_create).
ship_hero_wholesale_orders_complete
Fulfills the pending shipment of a wholesale order. The order must have exactly one pending shipment. Required: order_id, is_packed_externally. Send the FulfillWholesaleOrderInput fields as the request body (ShipHero mutation wholesale_order_fulfill).
update_a_ship_hero_wholesale_order_by_id
Updates a wholesale order and its line items. Required: id. The id is the order_id. Send the UpdateWholesaleOrderInput fields as the request body (ShipHero mutation wholesale_order_update).
ship_hero_wholesale_orders_submit
Marks a wholesale order as ready to pick. Required: order_id. Send the WholesaleOrderSetReadyToPickInput fields as the request body (ShipHero mutation wholesale_set_as_ready_to_pick).
list_all_ship_hero_wholesale_staging_locations
Fetch wholesale staging location candidates matching the supplied arguments. Required: warehouse_id. The connector pages through all results (50 per page; nested lists show their first 10 records).
create_a_ship_hero_work_order_fee
Adds ad hoc fees to a work order. Required: work_order_id, fees. Send the AddWorkOrderFeeInput fields as the request body (ShipHero mutation work_order_add_fees).
ship_hero_work_order_fees_bulk_delete
Removes ad hoc fees from a work order. Required: work_order_id, fees. Send the RemoveWorkOrderFeeInput fields as the request body (ShipHero mutation work_order_remove_fees).
ship_hero_work_order_fees_bulk_update
Updates ad hoc fees on a work order. Required: work_order_id, fees. Send the UpdateWorkOrderFeeInput fields as the request body (ShipHero mutation work_order_update_fees).
get_single_ship_hero_work_order_by_id
Fetch work order records matching the supplied arguments. Required: id.
list_all_ship_hero_work_orders
Fetch work orders matching the supplied arguments. The connector pages through all results (50 per page; nested lists show their first 10 records).
ship_hero_work_orders_assign
Assigns pick locations to the components of an assembly work order using FIFO or FEFO rules. Reports which component SKUs were assigned and which were not. Required: work_order_id. Send the AutoAssignPickLocationsInput fields as the request body (ShipHero mutation work_order_auto_assign_pick_locations).
ship_hero_work_orders_complete
Marks a work order as completed. Required: work_order_id. Send the CompleteWorkOrderInput fields as the request body (ShipHero mutation work_order_complete).
create_a_ship_hero_work_order
Creates a work order. Assembly work orders require an assembly SKU. Required: warehouse_id, requested_date, type. Send the CreateWorkOrderInput fields as the request body (ShipHero mutation work_order_create).
Why Truto
Why use Truto’s MCP server for ShipHero
Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 1050+ integrations.
Auto-generated, always up to date
Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.
Fine-grained access control
Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.
Multi-tenant by design
Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.
Works with every MCP client
Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.
Built-in auth, rate limits, and error handling
Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.
Expiring and auditable servers
Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.
How It Works
From zero to integrated
Start with ShipHero in a free sandbox, usually ready within one business day. No boilerplate, no maintenance burden.
Link your customer’s ShipHero account
Use Truto’s frontend SDK to connect your customer’s ShipHero account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.
We handle authentication
Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.
Call our API, we call ShipHero
Truto’s Proxy API is a 1-to-1 mapping of the ShipHero API. You call us, we call ShipHero, and pass the response back in the same cycle.
Unified response format
Every response follows a single format across all integrations. We translate ShipHero’s pagination into unified cursor-based pagination. Data is always in the result attribute.
FAQs
Common questions about ShipHero on Truto
Authentication, rate limits, data freshness, and everything else you need to know before you integrate.
How does authentication to ShipHero work through Truto?
ShipHero uses OAuth-style access tokens issued against user credentials. Truto handles the token exchange via the create access token flow and manages refresh so your end users connect once and your product gets a stable connection.
Is ShipHero's API REST or GraphQL?
ShipHero exposes a GraphQL API. Truto normalizes the GraphQL mutations and queries into standard tool calls, so you don't need to hand-write GraphQL documents, variables, or pagination cursors.
Can we subscribe to real-time events like order fulfillment or inventory changes?
Yes. Truto exposes ShipHero webhook management tools so you can programmatically create, enable, disable, update, and delete webhooks per connected account, and inspect webhook call logs for debugging.
Does the integration support both DTC and wholesale/B2B order flows?
Yes. There are separate tool sets for standard orders (create, update, tag, merge, cancel, complete) and wholesale orders including BOL generation, packing lists, picking sheets, staging transfers, and label printing.
Can we build 3PL-specific features like client billing?
Yes. The integration covers bills (create, submit, recalculate, update, delete), ad-hoc charges, fulfillment invoices, and account listing so you can automate 3PL billing per client account.
How fresh is inventory data and can we trigger snapshots on demand?
You can list inventory changes continuously and trigger inventory snapshots or inventory syncs on demand, then poll their status or cancel them. This lets you balance real-time accuracy with ShipHero's processing limits.
ShipHero
Get ShipHero integrated into your app
Our team understands what it takes to make a ShipHero integration successful. A short, crisp 30 minute call with folks who understand the problem.