Connect Shopify to Meldsy

Before you start

• Use a Shopify account with app-development permissions in the organization that owns your store. The app and store must belong to the same Shopify organization.
• Find the store’s permanent myshopify.com domain. Do not use its custom website domain or an admin.shopify.com URL.
• The current connection supports one Shopify store and one inventory location per Meldsy account. You can import the catalog before selecting a location, but quantity writes stay disabled.
• This guide is for the merchant-owned custom-app connection. You do not need Shopify CLI, an OAuth callback URL, or a manually copied Admin API access token.

Create your custom app in Shopify

1. Open Shopify Dev Dashboard and select the organization that owns the store. You can also start in Shopify admin → Settings → Apps → Develop apps → Build apps in Dev Dashboard.
2. Choose Create app → Start from Dev Dashboard. Give the app a recognizable name, such as Meldsy connection, and create it.
3. Open Versions and create a version. Set App URL to https://shopify.dev/apps/default-app-home and turn off embedding in Shopify Admin.

   

4. Set Webhooks API version to 2026-10. Keep this version even if Shopify offers a newer default; it matches Meldsy’s implemented connector.

Select these API access scopes

In the app version’s Scopes setting, choose Select from list, search for each of the nine permissions below, and select them, then choose Done. You can also paste the comma-separated list into the Scopes field.

The read permissions import products, customers, orders, inventory, locations, and fulfillment information. write_inventory allows the stock edits and optional linked inventory sync you choose in Meldsy. write_merchant_managed_fulfillment_orders enables the separately confirmed Complete in Shopify action.

• Order history normally covers the last 60 days. Extended order-history access is separate and is not part of this required list.

read_products,
read_orders,
read_customers,
read_inventory,
write_inventory,
read_locations,
read_fulfillments,
read_merchant_managed_fulfillment_orders,
write_merchant_managed_fulfillment_orders

Release and install the app version

1. Release the version containing the app URL, API version, and all nine scopes.
2. Open the app’s Overview and choose Install app in the Installs card. Select the store in the same organization and review Shopify’s installation permissions.
3. Install the app on that store. If you change scopes later, release the new version and approve the updated access on the store; saving a draft version alone does not update its permissions.
4. Open App settings in the Dev Dashboard. Locate the Client ID and Client secret for this app.

   

Enter the connection in Meldsy

1. In Meldsy, open Settings → Connections → Shopify.
2. Enter your Shopify store domain, for example your-store.myshopify.com, followed by the app’s Client ID and Client secret.

   

3. Review the terms and data-use acknowledgement if prompted, then choose Connect Shopify.
4. Wait for the first product and order import and automatic webhook setup. Open Listing selection and review the included products and variants.

   

Choose the inventory location

Meldsy uses one selected location; it does not add warehouses together or write to other locations. Eligible products must be Active, track stock at that location, and stop selling when out of stock. Draft, untracked, continue-selling, or otherwise unsupported stock stays unavailable for quantity writes.

1. In the connected Shopify settings, expand Advanced details.
2. Under Inventory location, choose Choose location, then select the warehouse whose available stock Meldsy should use.
3. Choose Save location. Check the product’s variants and current quantities before editing stock or enabling any cross-store group.

What works by default—and what needs setup

• Products and orders: photos, prices, SKUs, variants, visible personalization attributes, notes, totals, refunds, and fulfillment status import into Meldsy.
• Webhooks: Meldsy registers operational notifications automatically. Check Advanced details for 13/13 configured; you do not paste a callback URL into Shopify admin.
• Ship-by dates: Meldsy uses Shopify’s supplied fulfillment deadline. If none is supplied, it shows Not provided rather than inventing a deadline.
• Shipping labels: use Meldsy Label Bridge to return a Shopify label PDF to the matching print bundle, then review and confirm it. Manual PDF upload is also available.
• Financials: sales, refunds, and transaction fees supplied by Shopify can be shown. Missing fees, postage, and payouts are not treated as zero or complete profit.
• Production: local stage changes do not automatically fulfill an order in Shopify. Complete in Shopify is a separate, confirmed final-step action for eligible orders.

If the connection does not work