Get started with Nasam MM-API

Nasam MM-API (Marketplace Management API) gives your system the brands, marketplace accounts, catalog, orders, stock, sales and settlements your Nasam account already manages, and lets it act on them. You integrate with Nasam once; Nasam handles each marketplace.

Environment	Base URL	Keys
Production	`https://api.nasam.co/mm-api/v1`	`nsm_live_…`
Sandbox	`https://backend-test.nasam.co/mm-api/v1`	`nsm_test_…`, sample data refreshed nightly. See sandbox.

1. Create an API key

Sign in to the Nasam app and open Settings → API keys. Create a key and copy the token; it is shown once. The key acts as you, with your brands and your permissions. Keep it on your server. Authentication covers rotation, revocation and access.

export NASAM_API_KEY='nsm_live_…'

2. Check the key

curl 'https://api.nasam.co/mm-api/v1/me' \
  -H "Authorization: Bearer $NASAM_API_KEY"

GET /me returns the key's name and the user it acts as. A 401 means the key is wrong or revoked, or you sent a sandbox key to production.

3. Find your brands

curl 'https://api.nasam.co/mm-api/v1/brands' \
  -H "Authorization: Bearer $NASAM_API_KEY"

List brands returns a brands array and pagination. Each brand has a numeric id, which most other operations take as brandId or brandIds. This excerpt keeps only the fields the next step uses:

{
  "brands": [{ "id": 20, "name": "Brand name" }],
  "pagination": { "page": 1, "limit": 1, "total": 1, "totalPages": 1 }
}

4. Find the brand's marketplace accounts

curl 'https://api.nasam.co/mm-api/v1/brands/20/sale-channels' \
  -H "Authorization: Bearer $NASAM_API_KEY"

List a brand's marketplace accounts separates the brand's connected accounts from available channels. A sale channel is a marketplace in a region; a connected account is one brand's connection to it, with its own id, status, fulfillmentModel and inventoryScope. Keep the brand ID, sale channel ID and account ID apart. Brands and marketplace accounts explains which operations take which.

5. Read the brand's catalog

curl --get 'https://api.nasam.co/mm-api/v1/products' \
  --data-urlencode 'brandIds=20' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=10' \
  -H "Authorization: Bearer $NASAM_API_KEY"

List products returns products, categories, filterCounts and pagination. Each product carries its listings on the brand's connected accounts. Continue with catalog and listings.

Your task	Start here
Get told when orders, returns, purchase orders or brand health change	Webhooks
Match marketplace catalog items to products, push price and stock	Catalog and listings
Read orders and pack, cancel or ship them	Orders and fulfillment
Read stock, forecasts and drift	Inventory and planning
Read settled money, fees and statements	Profitability
Check whether marketplace data is current	Sync Health
Handle errors, the rate limit and retries	Errors, rate limits and retries

Every operation, field and permission is in the API reference. The OpenAPI 3.1 file generates typed clients. v1 changes only by addition; read versioning so your client tolerates new fields and enum values.

Support

Email general@nasam.co or message us on WhatsApp. Include the X-Request-Id of a failing request.

1. Create an API key​

2. Check the key​

3. Find your brands​

4. Find the brand's marketplace accounts​

5. Read the brand's catalog​

Next​

Support​