​

Introduction

Comprehensive Order Management System API for inventory, orders, and fulfillment

The MasonHub REST API enables you to programmatically manage your entire supply chain operations, from catalog management to order fulfillment and everything in between.

​

Endpoints

​

Core Resources

• Catalog Management: SKU management, product information, and catalog operations
• Order Management: Order creation, updates, cancellation, and lifecycle management
• Inventory Management: Real-time inventory tracking, allocation, and availability

​

Fulfillment Operations

• Inbound Shipments: ASN management and receiving operations
• Shipments: Outbound shipment tracking and carrier information

​

Integration Tools

• Callbacks & Events: Real-time webhooks for order and shipment events
• DataFactory: Testing utilities for simulating operations and generating test data

​

Authentication

You can generate an API key through your MasonHub dashboard. API keys are associated with your account and provide access to all MasonHub API endpoints.

​

Bearer Token Authentication

The MasonHub API uses JWT Bearer tokens for authentication. Include your token in the Authorization header of all requests.

Bearer tokens begin with the eyJ prefix and are used for all API operations. Keep your bearer tokens secret.

​

Using Your Token

Include the bearer token in the Authorization header:

curl -X GET "https://app.masonhub.co/{account}/api/v1/orders" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​

Base URLs

• Sandbox
• Production

https://sandbox.masonhub.co/{account_slug}/api/v1/

​

API Design Principles

The MasonHub API follows consistent design principles:

​

Data Formats

​

Date and Time

All timestamps use RFC3339 format for consistency:

2024-01-15T10:30:00Z

​

Pagination

Standard pagination parameters across all list endpoints:

​

Response Format

All responses follow a consistent structure:

{
  "limit": 30,
  "offset": 0,
  "list_type": "detail",
  "data": [
    // Array of results
  ]
}