# ShipHero GraphQL API

> Developer resources for the ShipHero GraphQL Public API: authentication, queries and mutations, webhooks, data exports, and the ShipHero MCP server and AI Skill.


## Data Exports
- [Available Data Tables](https://developer.shiphero.com/data-exports/tables.md): Data Exports can include the following tables. The API returns the tables present in the selected … - Published 2026-10-08
- [Handling Schema Changes](https://developer.shiphero.com/data-exports/schema-changes.md): Tables and columns in Data Exports can change over time. Build your integration so these changes … - Published 2026-10-08
- [Migrating to data_exports](https://developer.shiphero.com/data-exports/migrating.md): ShipHero provides three GraphQL queries for Data Exports:
Query Status Response lakehero_data_export … - Published 2026-10-08

## Troubleshooting
- [Error Glossary](https://developer.shiphero.com/troubleshooting/error-glossary.md): This page is a lookup reference for the errors the ShipHero Public API returns. Use it to go from … - Published 2026-10-08
- [Frequently asked questions](https://developer.shiphero.com/troubleshooting/faq.md): Why do some requests from Google Cloud return HTTP 403 while the same requests work from another … - Published 2026-10-20

## Flows
- [Inventory](https://developer.shiphero.com/flows/inventory.md): This section will explain the basic mutations and queries available for managing locations and … - Published 2025-10-22
- [Returns](https://developer.shiphero.com/flows/returns.md): In this section, we will guide you through the process of managing returns using our GraphQL Public … - Published 2025-10-18
- [Order Fulfillment](https://developer.shiphero.com/flows/order-fulfillment.md): Fulfilling an order in the ShipHero app involves several steps.
First, a shipment and its label are … - Published 2025-10-18
- [Purchase Orders](https://developer.shiphero.com/flows/purchase-orders.md): When managing Purchase Orders you might want to use the Public API to integrate.
In this case, the … - Published 2025-10-18
- [Transfer Orders](https://developer.shiphero.com/flows/transfer-orders.md): A Transfer Order moves inventory between two of your own warehouses. In the ShipHero UI, creating a … - Published 2026-05-13
- [Inbound Shipments](https://developer.shiphero.com/flows/inbound-shipments.md): Inbound Shipments represent incoming inventory deliveries to a warehouse. You can use the Public API … - Published 2026-03-09
- [3PL Billing](https://developer.shiphero.com/flows/3pl-billing.md): If you are a 3PL you might want to handle your client billing through the API, for example, if you … - Published 2025-10-18
- [Merge Orders](https://developer.shiphero.com/flows/merge-orders.md): This guide walks through a complete, real merge/unmerge flow using the ShipHero Public API.
1. List …
- [Assembly Products](https://developer.shiphero.com/flows/assembly-products.md): Assembly products let you sell one SKU that is made up of other SKUs. In ShipHero, you can manage … - Published 2026-05-27
- [Wholesale Orders](https://developer.shiphero.com/flows/wholesale.md): Wholesale orders in ShipHero are designed to handle B2B transactions, often involving EDI … - Published 2025-12-09
- [Wholesale Orders Packed Outside ShipHero](https://developer.shiphero.com/flows/wholesale-orders-packed-outside-shiphero.md): This complete flow leverages our Public API to enable third-party systems to fully automate B2B … - Published 2026-02-17
- [Import Packing Layout](https://developer.shiphero.com/flows/import-packing-layout.md): The wholesale_order_import_packing_layout mutation allows you to define the full packing structure … - Published 2026-03-18
- [Export Packing Layout](https://developer.shiphero.com/flows/export-packing-layout.md): The packing_layout field is available on the wholesale_order and wholesale_orders queries as well as … - Published 2026-04-02
- [Staging Locations](https://developer.shiphero.com/flows/staging-locations.md): Staging locations are specialized storage areas used primarily for wholesale order fulfillment. … - Published 2026-03-10
- [Cycle Counts](https://developer.shiphero.com/flows/cycle-counts.md): In this section, we will guide you through the process of managing cycle counts using the GraphQL … - Published 2026-04-21
- [Kits](https://developer.shiphero.com/flows/kits.md): Kits let you sell one SKU that is fulfilled from other component SKUs. In the Public API, kit … - Published 2026-06-30
- [Lots](https://developer.shiphero.com/flows/lots.md): Lots let you track inventory by expiration lot. In the Public API, lot management is handled by … - Published 2026-06-30

## Webhooks
- [Inventory Update](https://developer.shiphero.com/webhooks/inventory-update-webhook.md): This webhook will be called anytime the inventory quantity changes. The warehouse returned in the … - Published 2025-10-28
- [Inventory Change](https://developer.shiphero.com/webhooks/inventory-change-webhook.md): This webhook is triggered whenever the On Hand quantity changes. Unlike the Inventory Update … - Published 2025-12-26
- [Product Update](https://developer.shiphero.com/webhooks/product-update-webhook.md): Register this webhook using the name Product Update.
The webhook is triggered when:
A product is … - Published 2026-09-04
- [Shipment Update](https://developer.shiphero.com/webhooks/shipment-update-webhook.md): This webhook will trigger whenever an order gets fulfilled from shipping.shiphero.com as single … - Published 2025-10-28
- [Automation Rules](https://developer.shiphero.com/webhooks/ar-webhook.md): Although not strictly a webhook, it is built similarly, and it will help you power up your API … - Published 2025-10-22
- [Order Backorder](https://developer.shiphero.com/webhooks/order-backorder-webhook.md): Register this webhook using the name Backorder.
The webhook reports changes to the backordered … - Published 2026-09-04
- [Order Canceled](https://developer.shiphero.com/webhooks/order-canceled-webhook.md): ShipHero will call this URL when an order is canceled.
Webhook Body:
{ "order_number": … - Published 2025-10-22
- [Capture Payment](https://developer.shiphero.com/webhooks/capture-payment-webhook.md): ShipHero will call this URL to check if a payment was captured succesfully before the order is … - Published 2025-10-22
- [PO Update](https://developer.shiphero.com/webhooks/po-update-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2025-11-04
- [Return Update](https://developer.shiphero.com/webhooks/return-update-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2025-10-22
- [Tote Complete](https://developer.shiphero.com/webhooks/tote-complete-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2025-10-22
- [Tote Cleared](https://developer.shiphero.com/webhooks/tote-cleared-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2025-10-22
- [Order Packed Out](https://developer.shiphero.com/webhooks/order-packed-out-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2025-10-22
- [Package Added](https://developer.shiphero.com/webhooks/package-added-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2025-10-22
- [Print Barcode](https://developer.shiphero.com/webhooks/print-barcode-webhook.md): This webhook will be called anytime a product barcode would be generated.
The custom barcodes must … - Published 2025-10-22
- [Order Allocated](https://developer.shiphero.com/webhooks/order-allocated-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2025-10-22
- [Order Deallocated](https://developer.shiphero.com/webhooks/order-deallocated-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2025-10-22
- [Generate Label](https://developer.shiphero.com/webhooks/generate-label-webhook.md): Warning
Adding carriers using the Generate Label Webhook must be approved prior to use. Please … - Published 2025-11-12
- [Shipment ASN](https://developer.shiphero.com/webhooks/shipment-asn-webhook.md): This webhook is triggered when the “Submit ASN” button is clicked during step 3 … - Published 2026-04-01
- [Work Order Status Update](https://developer.shiphero.com/webhooks/work-order-update-webhook.md): This URL is the URL that you setup on your system, so we can push updates. This webhook will be … - Published 2026-04-16

## Changelog

## Root Pages
- [Getting Started](https://developer.shiphero.com/getting-started.md): This page covers the core concepts required to make your first query or mutation.
Tip
Need help with … - Published 2025-10-18
- [Scopes](https://developer.shiphero.com/scopes.md): Scopes limit what a ShipHero Public API token can read or change. They allow an application or AI … - Published 2026-08-19
- [ShipHero AI Toolkit](https://developer.shiphero.com/shiphero-ai-toolkit.md): ShipHero supports two ways to use AI with your ShipHero data: the ShipHero MCP and the Public API … - Published 2026-06-15
- [GraphQL Primer](https://developer.shiphero.com/graphql-primer.md): What is covered on this page:
Core concepts Identifiers Pagination 3PLs Error Handling & Support … - Published 2025-10-18
- [Examples](https://developer.shiphero.com/examples.md): This page provides example queries and mutations for common API operations.
Queries Mutations … - Published 2026-03-25
- [Experimental API](https://developer.shiphero.com/experimental.md): The Experimental API is a Beta-only GraphQL endpoint for customers who are testing new ShipHero API … - Published 2026-06-19
- [Robotic Picking Integrations](https://developer.shiphero.com/robotic-picking-integrations.md): ShipHero supports integrations with robotics systems used for warehouse picking.
These integrations … - Published 2026-08-19
- [Recurring Data Exports](https://developer.shiphero.com/recurring-data-exports.md): Warning
Recurring Data Exports is deprecated in favor of Data Exports. Use Data Exports for new … - Published 2026-02-25

---
Generated on 2026-10-30 12:38:35 UTC
Site: https://developer.shiphero.com/