Skip to main content

Connect MasonHub to Katana

Push Ready for fulfillment sales orders to MasonHub and import orders, tracking, inbound shipments, and stock levels.

A
Written by Argo Ohvril

What the Katana–MasonHub integration does

MasonHub is a third-party logistics and order-management platform for ecommerce brands. It combines fulfillment services with visibility into orders, inventory, shipments, returns, and carrier activity.

By connecting Katana with MasonHub, you can:

  • Import orders as sales orders: Each MasonHub order becomes a Katana sales order that keeps updating through later status changes, with fulfillments carrying carrier and tracking details.

  • Send sales orders to MasonHub for fulfillment: A Katana sales order is pushed to MasonHub as an outbound order when it reaches the Ready for fulfillment status.

  • Import products by SKU: Existing Katana products are matched by SKU, and SKU aliases can bridge mismatched SKUs.

  • See read-only stock levels: MasonHub on-hand quantities appear as External inventory at each warehouse's mapped Katana location.

  • Track inbound shipments as stock transfers: Each MasonHub inbound shipment becomes a Katana stock transfer that updates as quantities are received.

  • Map warehouses to locations: Each MasonHub warehouse links to its own dedicated Katana location.

sync diagram showing Katana on the left and MasonHub on the right: an arrow from Katana to MasonHub labeled 'Sales orders (Ready for fulfillment)', and arrows from MasonHub to Katana labeled 'Orders and fulfillments with tracking', 'Products by SKU', 'Inbound shipments → stock transfers', and 'Read-only on-hand stock at mapped locations'

Before you start

  • An active MasonHub account. Contact your MasonHub representative to set up API access.

  • The credentials MasonHub provides once API access is set up: your account slug/name and bearer token.

  • A Katana account with permission to manage integrations.

Connect MasonHub to Katana

  1. In Katana, open the Integrations page and find the MasonHub tile.

  2. Click Connect.

  3. Enter your MasonHub Account slug/name and Bearer token, then confirm.

    Katana MasonHub connection form showing two input fields labeled 'Account slug/name' and 'Bearer token', with a confirm button at the bottom

  4. Once MasonHub has approved the connection, the configuration screen opens on the Location tab. The integration status shows Connected with Sync inactive, and an Activate sync button appears in the header. Map each MasonHub warehouse to its own Katana location. Click Add to Katana to create the location automatically. Warehouses that are not yet mapped show Not mapped. You can pause a mapped warehouse with Unlink and resume it with Relink. Only mapped warehouses sync.

    Katana MasonHub configuration screen on the Location tab, listing MasonHub warehouses each with a status (Not mapped, mapped, or Unlinked) and an 'Add to Katana' button, with the integration status 'Connected' and 'Sync inactive' and an 'Activate sync' button in the header

  5. Click Activate sync to start syncing data with MasonHub. Nothing syncs before you do this.

How your daily workflow looks

  1. Your Katana sales order reaches Ready for fulfillment and is sent to MasonHub as an outbound order.

  2. MasonHub picks, packs, and ships the order.

  3. Orders and their status changes land in Katana as sales orders. Each shipped package becomes a fulfillment with carrier and tracking details.

  4. MasonHub inbound shipments appear in Katana as stock transfers. Received quantities update the transfers as they come in.

  5. MasonHub on-hand stock updates as read-only External inventory at your mapped locations. Reconciliation creates stock adjustments for any differences.

  6. You plan purchasing and production in Katana using up-to-date order and stock data.

Related Articles
Did this answer your question?