One integration for every marketplace Nasam manages.
Nasam MM-API (Marketplace Management API) gives your systems the brands, catalog and listings, orders, stock, sales and settlements in your Nasam account, and lets them act on orders, listings and inventory. You integrate once with Nasam instead of once per marketplace.
Who it’s for
Nasam connects to each marketplace and keeps the data in step. The API gives that work to your own systems.
Agencies running marketplace operations
You run marketplace operations for several brands under your own name. Read and act on every brand you manage in Nasam from your own tools and client reporting.
Companies with their own ERP, WMS or BI
You already run your business on your own systems. Bring Nasam’s marketplace orders, stock, sales and settlements into them, and send fulfillment and listing actions back.
From API key to marketplace data
Create a key, find a brand, and use its ID to read connected accounts and products.
- 1
Create an API key
Create a key in the Nasam app under Settings → API keys. It acts as you, with your brands and permissions. Send it from your server as
Authorization: Bearer. See authentication. - 2
Find a brand and account
List accessible brands, then read the selected brand’s connected sale-channel accounts. Keep the brand, channel, and account IDs distinct.
- 3
Read a brand’s catalog
Use the returned brand ID in a products request. Then subscribe to webhooks so you hear about order changes without polling.
A brand is the business scope. A sale channel identifies a marketplace and region. A sale-channel account is the brand’s connection to that channel. Use the IDs returned by the API in later requests.
Multi-channel API guideChoose a business workflow
Follow a guide for the sequence and business rules. Open its linked operations for parameters, response fields, and errors.
Establish context
Identify the brand and connected account for the data you want to read or change.
Run operations
Handle orders, retail purchase orders, and change notifications.
Measure and investigate
Investigate sales, profitability, Brand Health, and sync status.
API reference and tools
Download the OpenAPI 3.1 document for client tooling. Build against the sandbox, then switch to production.
Start building
Any Nasam user can create an API key in the app. For a sandbox key or help with an integration, write to us with the email of your Nasam user.
- Emailgeneral@nasam.co
- WhatsApp+966 55 009 0039