Skip to content

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

Use Cases

Why integrate with ShipHero

Common scenarios for SaaS companies building ShipHero integrations for their customers.

01

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.

02

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.

03

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.

04

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.

05

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.

01

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.

02

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.

03

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.

04

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.

05

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.

06

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.

01

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.

02

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.

03

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.

04

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.

05

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.

06

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.

01

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.

02

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.

03

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.

04

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.