Understanding the core data flows between your ERP and MasonHub systems

Architecture & Flows

Website

API Reference

Support

MasonHub ERP Integration

Contact Support

Complete guide for integrating your ERP system with MasonHub Order Management System using our public API

MasonHub ERP Integration Playbook

Understanding the MasonHub ERP Integration approach and requirements

Overview

How to request API access and credentials for MasonHub integration

Request Access

Essential API documentation and resources for your integration

Review Documentation

Complete testing guidelines for validating your MasonHub integration

Sandbox Testing

Comprehensive test cases for MasonHub API integration validation

Test Plan

Configure shipping service providers and service levels for proper order routing

Configuration

Retrieve data from MasonHub using periodic API polling

Polling via GET Calls

Receive real-time notifications from MasonHub via webhook callbacks

Callback Events (Webhooks)

Required fields and data for international shipping compliance

Commercial Invoice Requirements

Ensure your integration is ready for production deployment

Production Readiness Checklist

Final steps for deploying your MasonHub integration to production

Production Go-Live

Complete MasonHub Order Management System API reference and documentation

MasonHub API Documentation

Understanding the core principles and patterns that guide MasonHub API design

API Design Philosophy

JWT Bearer token authentication and security requirements for MasonHub API

Authentication

Understanding MasonHub logging, audit trails, and system transparency

The Stack Trace

Retrieve SKUs from the Item Master with flexible filtering and batch support

Get SKUs

Create SKUs

Update existing SKUs on the Item Master catalog

Update SKUs

Delete SKUs

Retrieve current inventory counts for specified SKUs across all distribution centers

Get SKU Inventory Snapshot

Initiate an asynchronous full inventory snapshot for large datasets

Request Full Snapshot

Retrieve information about warehouse locations and their UUIDs

Get Inventory Locations

Retrieve inbound shipment information with comprehensive filtering options

Get Inbound Shipments

Create one or more inbound shipments (ASN) to notify MasonHub of expected deliveries

Create Inbound Shipments

Update one or more existing inbound shipments (ASN)

Update Inbound Shipments

Soft delete inbound shipments by customer identifier

Delete Inbound Shipments

Retrieve orders with flexible filtering and response format options

Get Orders

Create one or more orders with comprehensive configuration options

Create Orders

Submit asynchronous order update requests

Update Orders

Retrieve status and details of order update requests

Get Order Updates

Submit asynchronous order cancellation requests

Cancel Orders

Retrieve status and details of order cancellation requests

Get Order Cancels

Retrieve outbound shipment information for orders fulfilled from MasonHub distribution centers

Get Order Shipments

Retrieve return (RMA) information with filtering and pagination

Get Returns

Create return authorizations (RMA) with automatic return label generation

Create Returns

Update existing return authorizations (RMA)

Update Returns

Delete return authorizations (RMA) by customer identifier

Delete Returns

Retrieve registered callback URLs filtered by message type

Get Callback URLs

Register new callback URLs for event notifications

Create Callback URLs

Delete Callback URLs

Webhook event sent when inventory levels change for SKUs across any location or status

SKU Inventory Change Event

Webhook event sent when full inventory snapshots are ready for download

Snapshot Ready

Webhook event providing real-time order lifecycle updates including status changes, shipments, and shorts

Order Events

Webhook event sent when asynchronous order update requests are resolved

Order Update Resolutions

Webhook event sent when asynchronous order cancel requests are resolved

Order Cancel Resolutions

Webhook event sent when inbound shipment status changes during the receiving process

Inbound Shipment Events

Webhook event sent when return merchandise authorization (RMA) status changes or items are received

RMA Events

List current callback holds by message type

Get Callback Holds

Place holds on specific message types to suspend callback delivery

Create Callback Holds

Remove holds to resume callback delivery for specific message types

Delete Callback Holds

Simulate adding inventory in available status (Sandbox only)

Create Available Inventory

Simulate inventory loss by moving units to lost status (Sandbox only)

Lose Inventory

Simulate order fulfillment and shipping (Sandbox only)

Ship Order

Simulate carrier delivery events for shipments (Sandbox only)

Order Shipment Event

Force resolution of pending order update requests (Sandbox only)

Resolve Order Update

Force resolution of pending order cancel requests (Sandbox only)

Resolve Order Cancel

Simulate inbound shipment receiving events (Sandbox only)

Trigger Inbound Shipment Event

Simulate RMA receiving and processing events (Sandbox only)

RMA Event

Generate a new JWT bearer token using a secret phrase

Generate New Bearer Token

Remove secret phrases to invalidate associated bearer tokens

Delete Secret Phrase

How to reach MasonHub support for assistance with your integration

Contact Information

Common issues and solutions for MasonHub integrations

Architecture & Flows

Core Flows

ERP → MasonHub:

MasonHub → ERP:

On this page

​Core Flows

​ERP → MasonHub:

​MasonHub → ERP:

On this page

Core Flows

ERP → MasonHub:

MasonHub → ERP: