The Melonn API lets sellers integrate their systems with the services Melonn offers: creating and tracking sell orders, managing products, checking inventory, sending merchandise to our warehouses and handling buyer returns. This guide covers:
  • The available functionality, grouped by domain in the API reference.
  • The reference data you need to build requests, such as warehouse and shipping method codes.
  • The webhooks you can subscribe to, so your systems are notified when something changes.

Authentication

Generate your API key and send it with every request.

Environments

Test your integration in the sandbox before going live.

Reference data

Warehouses, shipping methods, VAS and official destinations.

Webhooks

Receive events at your own URL.
Building with an AI coding agent? Point it to /llms.txt on this site, an index of every page, or give it /openapi.yaml, the complete contract with every endpoint, schema and webhook event.

​
Concepts and definitions

Grouping multiple items into a single SKU. This allows you to set up your sales channel selling a single SKU but have your inventory unconsolidated in Melonn. It does not imply that Melonn has to consolidate these items in any particular way during packaging.
Melonn distribution centers, warehouses or storage facilities.
Used to deliver an order from the warehouse to the final destination. Each shipping method determines the carrier, delivery time frame, and logistics conditions (for example, same-day delivery, standard delivery, pickup, or express service).
Your own stores, retailers or distributors to whom you send merchandise with B2B orders. Each of them may have one or more delivery points.
Orders usually placed by an individual customer, typically with a low quantity of items.
A bundle that also includes some additional packaging preparation, such as placing items in a box or bag, closing with a sticker, or heat shrinking.
Services on top of the traditional fulfillment concepts of storage, preparation and transportation. See the VAS catalog.
You can find more material about integrating with Melonn in Learn with Melonn.