1. Introduction
  2. Overview

​
Overview

This playbook is designed for technical teams integrating their ERP systems with the MasonHub Order Management System (OMS) using our public API. It outlines required steps, supported integration flows, validation testing, and production readiness.

​
Integration Approach

Our integration follows industry best practices for API-based system integrations:

API-First Design: All integrations are built using RESTful APIs with JSON payloads, ensuring compatibility with modern ERP systems.

​
Key Benefits

​
Prerequisites

Before starting your integration, ensure you have:

  • Technical Resources: Developer familiar with REST APIs and your ERP system
  • System Access: Administrative access to your ERP system for configuration
  • Testing Environment: Ability to test in a sandbox environment
  • MasonHub Account: Active MasonHub account with API access permissions

​
Integration Timeline

A typical integration follows this timeline:

1

Planning & Access (1-2 days)

Request API access and review documentation

2

Development (1-2 weeks)

Build integration endpoints and data mappings

3

Testing (3-5 days)

Complete comprehensive sandbox testing

4

Production Deployment (1-2 days)

Go-live with production credentials and monitoring

​
Next Steps

Ready to get started? Begin with requesting access to the MasonHub API and sandbox environment.