ShipHero as a Source
Summary
ShipHero is a warehouse and fulfillment (WMS/3PL) platform connected to Flxpoint over its API using an Access Token and a Refresh Token. As a source it imports on-hand inventory and pricing, sends fulfillment requests, and pulls back shipment tracking. It is typically configured as an External Warehouse source type to reflect a 3PL relationship.
Complete the Source Wizard, then open the source's Integrations tab → Start Creating Integrations → select the ShipHero integration. On the connection dialog click Create New Connection and enter the values below, then Test Connection → Save Connection.
access_token and refresh_token. If Test Connection fails, re-paste both tokens (they may have expired or been rotated), confirm the app has scope for orders, inventory and shipments, and retry after a few minutes in case of rate limiting.Send Fulfillment Requests requires Title to be mapped — orders fail without it
ShipHero requires a Title value on every order line item, and it is not populated automatically. In the Send FR template, map Order Item → Title from Source Shipping Method → Name (a Shipping Method defined on the source with a Carrier + Method + Name). Without a Title, every Send FR submission is rejected — this is the most common Send FR configuration error.
Warehouse ID is optional — leave it blank to aggregate all ShipHero warehouses
The Warehouse ID field in both Get Inventory (Primary) and Send Fulfillment Requests is optional. Blank means inventory is summed across all warehouses (Available and On-Hand are summed; Price/Value uses the lowest non-zero found) and fulfillment routes per your ShipHero account logic. Specify a Warehouse ID only to lock reads or routing to one facility. You can change it at any time.
Access Token is short-lived — the Refresh Token handles renewal
ShipHero access tokens expire periodically; Flxpoint uses the Refresh Token to renew them automatically, so you don't re-enter the Access Token each run. But if tokens are rotated or revoked in ShipHero (Settings → Developers → Public API), update both the Access Token and Refresh Token in the Flxpoint connection immediately or all operations fail with auth errors.
Enable Archive on only one inventory job — never both
If you run both Get Inventory (Primary) and Get Inventory (Secondary) on a ShipHero source, turn on Archive/Un-Archive on only one of them (typically Primary). Enabling it on both causes double-archiving — items can be deactivated while still present in the ShipHero feed.
| ShipHero Field | Maps To – Notes |
|---|---|
| SKU | → SKU. Required — primary identifier for the variant. |
| Available Quantity | → Quantity. Required — usable stock for sale. Summed across all warehouses when Warehouse ID is blank. |
| On Hand Quantity | → Quantity (alt) / Reference. Optional — total physical stock, usable for logic or validation. |
| Price / Value | → Cost. Optional — maps to your cost field as configured. Uses the lowest non-zero value when aggregating warehouses. |
| Source Field | Maps To (ShipHero) – Notes |
|---|---|
| Fulfillment Request Number | → PO / Reference. Required — unique per order. |
| Shipping Address (name, street, city, region, postal, country, phone, email) | → Ship-To. Required — provide full destination details, including contact phone/email where required. |
| Order Items → SKU | → Line SKU. Required — item identifier. |
| Order Items → Quantity | → Line Qty. Required — units requested. |
| Source Shipping Method → Name (or Carrier + Method) | → Order Item → Title. Required — ShipHero rejects orders without a Title. Define Shipping Methods on the source to supply it. |
| Static value or Step Setting | → Warehouse ID. Optional — blank lets ShipHero route per account logic; a value targets that warehouse. |
| ShipHero Field | Maps To – Notes |
|---|---|
| Shipping Carrier | → Carrier. Recommended — e.g. UPS, FedEx, USPS. |
| Shipping Carrier Method | → Method. Optional — e.g. Ground, 2 Day. |
| Label / Shipping Cost | → Shipping Cost. Optional — captured if provided by ShipHero. |
| Tracking Number | → Tracking Number. Required — used to update the FR shipment record. |
| (Derived / carrier URL) | → Tracking URL. Optional — provide a carrier link if available, or build one with a rule. |
| Notes / Comments | → Notes. Optional — extra detail from ShipHero. Controlled by the FR Lookback Period for Get Shipments (default 90 days); widen it if older FRs still need tracking. |
How do I get the Access Token and Refresh Token for ShipHero?▸
access_token and refresh_token. Paste both exactly as issued (no extra spaces) into the Flxpoint connection; scope should include orders, inventory and shipments.What does Get Inventory (Primary) import from ShipHero?▸
How do I configure the Title field for Send Fulfillment Requests?▸
UPS Ground); that Name is passed as the Title on every line. You can also use a conditional rule to set the Title by weight or tier — the key is that Title is never empty, or ShipHero rejects the order.