Sync orders and inventory with ShipHero WMS using the GraphQL API

Steps

1. Authenticate by obtaining an OAuth 2.0 Bearer token from ShipHero; include it in the Authorization header on all requests to the GraphQL endpoint at https://public-api.shiphero.com/graphql.
2. Create an order by sending the order_create mutation with fields including order_number, partner_order_id, required_ship_date, shipping address, and a line_items array containing sku, quantity, and price.
3. Query order fulfillment status using the order query with the order ID; the response includes fulfillment_status, shipments (with tracking numbers), and line-level pick/pack state.
4. Adjust inventory by calling the inventory_add or inventory_remove mutation with sku, warehouse_id, quantity, reason, and location; for a bulk replacement use inventory_replace.
5. Subscribe to inventory-change webhooks from the ShipHero dashboard; the payload includes the sku, warehouse_id, and the delta quantity so you can mirror stock levels in your commerce platform.
6. For 3PL accounts, always include the customer_account_id field in mutations to scope operations to the correct merchant account within the shared warehouse.