Developer Resources
ShipHero GraphQL Public API
ShipHero’s public API provides access to platform data and operations for custom integrations. It is built on GraphQL, allowing clients to request exactly the fields they need for each workflow.
Quick Access
Need help with your integration? Visit our Troubleshooting guide for common issues and solutions.
Latest Changes
Added ship_date to purchase_order_create and purchase_order_update. On purchase_order_update, set clear_ship_date to true to clear it.
Added the experimental cheapest_profiles query for listing the RateShop+ profiles of your account, with their assigned clients and their shipping methods grouped by carrier. See Cheapest Profiles Query.
Added inbound_shipment_delete to soft-delete inbound shipments in PENDING_ARRIVAL or ARRIVED status. See the Inbound Shipments flow.
Added updated_at to WholesaleOrder. It returns the last update of the wholesale order record in UTC, the same timestamp that updated_from and updated_to on wholesale_orders filter on. Changes confined to related records, such as the underlying order, line items or shipping details, may not move it. For the underlying order’s timestamp, select order.updated_at. See Filter by update time.
Changed bill_update to look bills up only within the authenticated account before checking their status. A bill that doesn’t exist, or that belongs to another account, now returns Bill not found with code 9 regardless of its status. An id that matched no bill used to return Unexpected Error with code 22. Status transitions and their errors for your own bills are unchanged. This applies to bill_update only. See Billing errors.
Changed updated_from and updated_to on wholesale_orders to filter on the wholesale order’s last update instead of the underlying order’s, so status changes such as Warehouse Complete now show up even before fulfillment. updated_to is exclusive. To track changes to the underlying order, use orders. See Filter by update time.
Published the Error Glossary with API error codes, common causes, and messages by operation to help diagnose failed requests.
Deprecated cycle_count_enabled on Account. Cycle counting is enabled for all accounts, so the field now always returns true. Existing queries keep working, but integrations should stop using it to decide whether cycle counting is available. See the Cycle Counts flow.
