---
title: ShipHero API Integration on Truto
slug: shiphero
category: E-Commerce
canonical: "https://truto.one/integrations/detail/shiphero/"
---

# ShipHero API Integration on Truto



**Category:** E-Commerce  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 202 tools for ShipHero that AI agents can call directly.

- **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).

## How it works

1. **Link your customer's ShipHero account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach ShipHero.** The Proxy API is a 1-to-1 mapping of the ShipHero API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

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

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

## FAQs

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