# ShipBob return grading for refunds > Let ShipBob's return scan 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/shipbob - Last updated: 2026-09-24 Connect ShipBob 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. **Create a ShipBob token**: In ShipBob, open Integrations, then API Tokens, and create a personal access token. 3. **Connect ShipBob**: An Owner or Admin pastes the token in the Warehouse section of the Integrations page. Lumtry registers its return notifications and ShipBob issues the signing secret. 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 events: arrived, completed, and each item's received quantity and restock, dispose or quarantine action. - 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 ShipBob. ## 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 ShipBob events? ShipBob signs every event with the secret it issued when you connected. Lumtry checks the signature and a five minute timestamp window 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. - [ShipHero](https://lumtry.com/connectors/shiphero.md): Let ShipHero's return updates 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)