Help

How to connect your store.

Every connection MelQart supports is a scoped, read-mostly credential you generate yourself — never your storefront login. Find your platform below for the exact steps.

Shopify

A Custom App access token from your own Shopify Admin — not a Storefront API token, and not your public storefront domain.

  1. In Shopify Admin, go to Settings → Apps and sales channels → Develop apps.
  2. Click "Create an app", give it a name (e.g. "MelQart"), then open it.
  3. Under Configuration → Admin API integration, click Configure and enable the scopes read_products and read_inventory (add price-write scopes only if MelQart is approved to write prices back on your plan).
  4. Save, open the API credentials tab, and click Install app.
  5. Copy the Admin API access token — it starts with shpat_ and is shown only once.
  6. For "Shop URL", use the domain shown in your browser while you’re inside Shopify Admin. It always ends in .myshopify.com (e.g. acme-shop.myshopify.com) — never your public storefront domain (e.g. acme-shop.com). Shopify’s Admin API only accepts the myshopify.com host, even if your storefront uses a custom domain.

WooCommerce

REST API keys (recommended) or a WordPress username + Application Password.

  1. REST API keys: in WordPress admin, go to WooCommerce → Settings → Advanced → REST API.
  2. Click Add key, name it "MelQart", set Permissions to Read, then Generate API key.
  3. Copy the Consumer key (ck_...) and Consumer secret (cs_...) — the secret is shown only once.
  4. Application Password (alternative): go to Users → Profile → Application Passwords, enter a name, click Add New Application Password, and copy the generated password (format xxxx xxxx xxxx xxxx xxxx xxxx). Use it together with your normal WordPress username.
  5. Store URL is your site’s base URL, e.g. https://shop.example.com.

Vendure

Either your Vendure admin email + password, or a bearer token if your instance issues one.

  1. If your Vendure instance has a custom auth strategy or API-key plugin that issues bearer tokens, generate one there and use "API Token" mode below.
  2. Otherwise, use "Email & Password" mode with your normal Vendure Admin UI login — MelQart authenticates through Vendure’s own admin login mutation, the same as signing into the Admin UI.
  3. Shop URL is your storefront’s base URL (e.g. https://shop.example.com) — MelQart automatically tries both /admin-api and /shop-api, and an api.<yourdomain> fallback.
  4. Your password is never stored — only the session token Vendure issues in response is kept, and only for syncing.

Magento

A Magento 2 Integration access token with Catalog API access.

  1. In Magento Admin, go to System → Extensions → Integrations.
  2. Click Add New Integration and name it "MelQart".
  3. On the API tab, grant access to the Catalog resource (add Sales too if you plan to use order-based reporting later).
  4. Save, then Activate the integration — Magento will display an Access Token. Copy it now; it isn’t shown again.
  5. Store URL is your site’s base URL, e.g. https://magento.example.com.

Salla

An access token scoped to catalog read access.

  1. From your Salla merchant dashboard or Partner account, open the app/API settings where access tokens are issued.
  2. Generate an access token with catalog read permission and copy it.
  3. API base URL is Salla’s API host, https://api.salla.dev/admin/v2 — already pre-filled, no need to change it.

Zid

An access token plus your Zid Store ID.

  1. In your Zid merchant dashboard, go to API Settings (developer/integration section).
  2. Generate an access token and copy it.
  3. Copy your Store ID from the same settings screen.
  4. API base URL is https://api.zid.sa/v1 — already pre-filled.

Noon

A Seller API key plus your Seller ID.

  1. Sign in to Noon Seller Lab and open API Settings.
  2. Copy your Seller API key and your Seller ID.
  3. API base URL is https://api.noon.com/seller/v1 — already pre-filled.

Amazon SP-API

LWA refresh token, client ID and client secret from Seller Central.

  1. In Amazon Seller Central, go to Apps & Services → Develop apps for Selling Partner API.
  2. Create (or open) your app and authorize it against your own seller account to obtain a Refresh Token.
  3. Copy the LWA Client ID and Client secret from your developer profile.
  4. Set the SP-API endpoint to match your marketplace region, e.g. https://sellingpartnerapi-na.amazon.com for North America.
  5. Marketplace ID is optional — leave it blank to default to the US marketplace (ATVPDKIKX0DER).

Still stuck?

A connection should never need guesswork.

If a Test Connection still fails after following these steps, email us the exact error and we’ll walk through it with you.

Email support@melqart.meSee connection capabilities