$0 platform fees. You pay for product, storage and fulfillment. $0 platform fees, ever.
  1. Home
  2. Help center
Resources

Building with the Merch API

A short tour of the REST API and webhooks. Pick the article that maps to what you want to do.

The Merch REST API lets you read and write orders, products, inventory, campaigns, and contacts from your own systems, and subscribe to webhooks for event-driven updates.

Last updated May 7, 2026All Developers articlesOn this page

Who this is for

You are integrating Merch into another application — a CRM, an HR onboarding flow, an internal store, a fulfillment dashboard, or a custom tool. If you are managing orders by hand in the customer portal, the customer-facing categories are a better fit. The articles here assume you are writing code.

What you can do

  • Orders — list, fetch, create, and cancel fulfillment orders. Pick a warehouse to route from. Track shipment status.
  • Products — list active product variants and their SKUs, dimensions, weights, and minimum order quantities.
  • Inventory — read on-hand, available, allocated, and inbound stock per warehouse, plus the underlying inventory event log.
  • Campaigns — list the campaigns on your account. Order creation and invites both reference a campaignId.
  • Invites and contacts — add contacts to a campaign and send personalized invites by email or with a redemption URL.
  • Webhooks — subscribe to event notifications for order and invite lifecycle changes. Each delivery is signed with HMAC-SHA256 so you can verify it came from Merch.

How requests work

The base URL is https://api.merch.com. All routes are mounted under /v1. Every request needs a Authorization: Bearer <your_api_key> header. Request and response bodies are JSON.

Testing your integration

There is no sandbox or test environment today — you'll integrate against production. We recommend creating a separate test API key, marking test orders clearly (a notes value or a recipient name pattern you can filter on), and using POST /v1/webhooks/{id}/test to validate webhook delivery before going live. See Webhooks reference for the test endpoint details.

Where to start

  • Authentication and API keys — generate a key and send it on every request.
  • API reference overview — base URL, error shape, status codes, pagination.
  • Rate limits — 1,000 requests per 24-hour window per IP.
  • Errors and status codes — what to expect and how to handle each one.
  • Orders API — list, fetch, create, cancel.
  • Campaigns API — list campaigns to feed into order creation.
  • Products API — list variants and SKUs.
  • Inventory API — stock levels and movements.
  • Invites and contacts API — campaign-scoped contact and invite management.
  • Webhooks reference — subscribe, verify, and test event deliveries.

All Developers articles

  • Authentication and API keysGenerate an API key, send it on every request, and rotate it when needed.
  • API reference overviewBase URL, JSON conventions, errors, pagination, and how the API versions.
  • Rate limitsEach key is limited to 1,000 requests per 24-hour window.
  • Errors and status codesThe error shapes you'll see and what each code means.
  • Orders APIList, fetch, create, and cancel fulfillment orders.
  • Campaigns APIList the campaigns on your account.
  • Products APIList your products and variants.
  • Inventory APIRead your stock levels and stock movements.
  • Invites and contacts APIAdd contacts to a campaign and send personal invites.
  • Webhooks referenceSubscribe to event notifications, verify signatures, and inspect deliveries.

On this page

  • Who this is for
  • What you can do
  • How requests work
  • Testing your integration
  • Where to start
In this section
  • Building with the Merch API
  • Authentication and API keys
  • API reference overview
  • Rate limits
  • Errors and status codes
  • Orders API
  • Campaigns API
  • Products API
  • Inventory API
  • Invites and contacts API
  • Webhooks reference

Ready to build your merch?

Custom design, production, campaigns, and global fulfillment. One partner, zero platform fees. Nothing off a catalog.

Request an account and our team will set it up with you on a quick discovery call.