# ShipHero return grading for refunds > Let ShipHero's return updates release the refund and grade each item. Part of the Warehouse Sync add-on on Starter, Growth and Scale. - Canonical URL: https://lumtry.com/connectors/shiphero - Last updated: 2026-09-24 Connect ShipHero to Lumtry with the Warehouse Sync add-on and the warehouse scan becomes the proof of return. When every item on a return is received, Lumtry releases the refund or sends it to inspection, grades each item from the warehouse outcome, and leaves quarantined items for a person to decide. ## What it does - Marks a return received once every item has arrived at the warehouse, then releases the refund or moves it to inspection. - Grades each item from the warehouse outcome: restocked counts as new, disposed or missing counts as unusable. - Gives your policy stock on hand and the latest warehouse disposition, when a rule asks for them. ## Set it up 1. **Add Warehouse Sync**: Warehouse Sync is an add-on on Starter and Growth and included on Scale. It is not available on Free. 2. **Prepare a ShipHero API user**: Use the email and password of a ShipHero API user. Lumtry exchanges them once for tokens and never stores the password. 3. **Connect ShipHero**: An Owner or Admin enters the credentials in the Warehouse section of the Integrations page. Lumtry registers its return notification and renews ShipHero tokens before they expire. 4. **Choose grade confirmation**: Turn on Require confirmation for warehouse grades if a teammate should confirm each grade before it counts. It is off by default. ## What Lumtry reads - Signed return updates: received, complete, and each item's quantity and whether it was restocked. - Stock on hand by SKU, only when your published policy uses a warehouse field. - The store order reference on each return, to match it to a case waiting for its return. ## What Lumtry writes - Its return notification subscription, created when you connect and removed when you disconnect. - Nothing else. Lumtry never creates returns, orders or inventory changes in ShipHero. ## Frequently asked questions ### What does Warehouse Sync cost? $79 a month on Starter or Growth, included on Scale, and not available on Free. If the add-on lapses, the connection pauses: events are still verified and recorded but no longer change cases. ### Does a warehouse grade overwrite a teammate's grade? No. A grade a person already set is never overwritten, and quarantined or unknown outcomes always wait for a person. ### What about a return that arrives in parts? Nothing is final until every item is received. A partial delivery never releases a refund on its own. ### How does Lumtry verify ShipHero events? ShipHero signs every return update with the secret it issued when Lumtry registered the notification. Lumtry checks that signature before it records anything, and drops redeliveries. ## Related - [Home](https://lumtry.com/index.md): Decide refunds by a versioned policy, send the exceptions to your team in Slack or the dashboard, and keep every step on the record. Start free. - [Integrations](https://lumtry.com/connectors.md): Connect Lumtry to Shopify, WooCommerce, BigCommerce, Amazon, eBay, Stripe, PayPal, Slack, Gorgias, Zendesk, EasyPost and Shippo. Browse every integration. - [Register a connector](https://lumtry.com/connectors/register.md): Directories and AI assistant vendors register their OAuth client metadata here. The team reviews every registration before a workspace can authorize it. - [Shopify](https://lumtry.com/connectors/shopify.md): Connect Shopify to Lumtry so refund requests and order details reach one versioned policy, with every decision kept in an append-only audit trail. - [WooCommerce](https://lumtry.com/connectors/woocommerce.md): Connect WooCommerce with REST API keys. Lumtry opens a case when a refund is recorded, decides it by policy and pays through Stripe or PayPal. - [BigCommerce](https://lumtry.com/connectors/bigcommerce.md): Connect BigCommerce with an API account or the app. Each refund on an order becomes a case your policy decides, paid through Stripe or PayPal. - [Amazon Returns](https://lumtry.com/connectors/amazon.md): Bring Amazon return and refund notifications into one policy-driven queue. Set up with the Lumtry team; nothing is written back to Amazon. - [eBay](https://lumtry.com/connectors/ebay.md): Bring eBay return and refund notifications into one policy-driven queue. Set up with the Lumtry team; nothing is written back to eBay. - [Stripe](https://lumtry.com/connectors/stripe.md): Connect Stripe through Stripe Connect. Approved refunds are paid from the original charge with an idempotency key, so a retry never pays twice. - [PayPal](https://lumtry.com/connectors/paypal.md): Connect PayPal with your REST app credentials. Approved refunds are paid from the original capture, and every PayPal event is signature-checked. - [Slack](https://lumtry.com/connectors/slack.md): Approve or deny held refunds from a Slack channel. Lumtry checks the signature, a single-use token and the approver before it acts. - [Gorgias](https://lumtry.com/connectors/gorgias.md): Tag a Gorgias ticket and Lumtry opens a refund case for the matching order, then posts each step back as an internal note. - [Zendesk](https://lumtry.com/connectors/zendesk.md): Tag a Zendesk ticket and Lumtry opens a refund case for the matching order, then posts each step back as a private comment. - [Twilio](https://lumtry.com/connectors/twilio.md): PIN-checked phone approvals for held refunds to US numbers, placed through Twilio by Lumtry. A voice approvals add-on on paid plans. - [Telnyx](https://lumtry.com/connectors/telnyx.md): PIN-checked phone approvals for held refunds to Canadian numbers, placed through Telnyx by Lumtry. A voice approvals add-on on paid plans. - [EasyPost](https://lumtry.com/connectors/easypost.md): Buy prepaid return labels on your EasyPost account and release the refund when the carrier shows the return delivered. - [Shippo](https://lumtry.com/connectors/shippo.md): Buy prepaid return labels on your Shippo account and release the refund when the carrier shows the return delivered. - [ShipBob](https://lumtry.com/connectors/shipbob.md): Let ShipBob's return scan release the refund and grade each item. Part of the Warehouse Sync add-on on Starter, Growth and Scale. - [Pricing](https://lumtry.com/pricing.md): Lumtry plans by case volume and seats, from Free to Enterprise, with add-ons and capped outcome fees. Start free or hear when billing opens. - [MCP server](https://lumtry.com/developers/mcp.md): Connect an AI assistant or your own agent to your refund workspace through the Model Context Protocol. Read cases and propose actions, never move money. - [Trust](https://lumtry.com/trust.md): How Lumtry secures merchant data, keeps AI inside a deterministic refund policy, lists every sub-processor and explains data flow and retention. Review it. - [llms.txt](https://lumtry.com/llms.txt)