ZenotiHelp

Connect a Shopify store

ZTZenoti Docs Team Updated September 5, 2026 10 min readGuide

Integrate your Shopify online store with Zenoti so Shopify orders become Zenoti invoices and products, inventory levels, customers, and gift cards stay in step. The connection lives on the ECommerce accordion of the Integration settings page. This article covers the accordion's panels in setup order: Configuration, Authorize, Manual Sync, Locations, Payments Mapping, Sync Schedule, and Shop β€” the seven panels shown before a store is configured β€” plus Subscriptions, which appears once the configuration is saved, and Marketplace Order Mapping, which appears when Enable Marketplace Order Mapping is on. Day-to-day syncing is covered in Sync Shopify orders and products.

Note: Products, prices, and inventory levels for items sold through Shopify are maintained in Zenoti. For day-to-day catalog sync operations, see eCommerce integration.


On this page


Before you begin

Permission: You need organization administrator access to configure the Shopify integration.

  • One store per organization: a Zenoti organization connects to exactly one Shopify store.
  • Default center: decide which Zenoti center owns Shopify orders (revenue, inventory movement, and tax are attributed there).
  • Admin access to Shopify: you need a Shopify admin login that can create a custom app and install it, and the app's API key and API secret key.
  • Test store (recommended): validate the order-to-invoice flow against a Shopify development store before connecting your live store.

External-system prerequisites (Shopify side)

Complete these steps in Shopify before starting in Zenoti. The exact menu paths vary by Shopify admin version; refer to Shopify's documentation.

  1. Create the app in Shopify and record its API key and API secret key. Zenoti asks for both in the Configuration panel.
  2. Ensure an admin can approve the install. The user who runs Authorize Now must be signed in to Shopify as an admin who can install an unlisted app.
  3. (Shopify Plus only) Generate a Multipass secret so Webstore guests can move to your Shopify storefront without signing in again.
  4. Confirm products carry SKUs. Zenoti maps Shopify products to its inventory by SKU; mismatches are the most common cause of order sync failures.

If your Shopify admin is a separate person or agency, forward this checklist to them; Zenoti cannot complete any of these steps on the Shopify side.


Network requirements

Shopify is a hosted SaaS platform, so there is no on-premise network to whitelist.

Direction Purpose Protocol / port What to whitelist
Zenoti β†’ Shopify Admin API calls from Zenoti (orders, products, inventory, customers, gift cards). HTTPS / 443 Outbound from Zenoti; managed by Zenoti.
Shopify β†’ Zenoti Webhook callbacks for the topics you subscribe to. HTTPS / 443 No customer action.

Enter the store configuration

  1. Navigate to Configuration > Integrations > Integration settings and expand ECommerce.

  2. Open Configuration and complete the store details.

    Field What to enter
    Ecommerce Platform Choose your Shopify plan from the list (Select Ecommerce platform).
    Store URL Your store's domain between the fixed https:// and .myshopify.com parts. Zenoti asks you to Enter Store Name.
    API KEY, API SECRET KEY The credentials of the app you created in Shopify (Enter API KEY, Enter API SECRET KEY). Select Edit to change them later.
    Multipass Secret Shopify Plus only. The Multipass secret key from Shopify Plus admin.
    Sync Start Date The first order date Zenoti processes (Select Sync Start Date). Orders before it are ignored.
    Default Center The Zenoti center that owns Shopify orders (Choose the Default Center).
    Default Custom Payment The custom payment method recorded on Shopify invoices when a gateway is not mapped (Choose the Default Payment Option).
    Default Employee The employee recorded as the seller on Shopify invoices (Choose the Default Employee).
  3. Set the switches that fit your operation.

    Switch Effect
    Enable Inventory GraphQL Uses Shopify's GraphQL inventory API for stock calls.
    Enable Inventory Stock V2 Uses Zenoti's inventory V2 stock model. Zenoti requires the inventory migration to be complete: Enable DefaultLock and MigrationComplete flag to enable InventoryV2.
    Add vendor for products when the product is added from Shopify Creates the product's vendor in Zenoti when a Shopify product is imported.
    Add authorized payments. Records Shopify payments that are authorized but not yet captured.
    Enable Queue Processes webhook events through a queue instead of immediately.
    Enable Gift Cards Syncs Zenoti gift cards to Shopify. With it on, choose the Date Criteria for gift card postings: Sale Date (invoice created date) or Close Date (invoice close date).
    Enable Marketplace Order Mapping Turns on the Marketplace Order Mapping panel for orders that arrive through marketplaces.
    Active Turns the integration on.
  4. Select Save. Zenoti confirms with Changes has been saved successfully.

Until the configuration is saved, the other panels show Configure settings to authorize, Configure settings to proceed with manual sync, and similar messages with a Configure Now link.


Choose the webhook subscriptions

  1. Open Subscriptions. The grid lists each EVENT with the Shopify TOPICS Zenoti listens to, such as orders/paid, orders/fulfilled, and orders/partially_fulfilled.
  2. Select the events you need and select Save.
  3. After authorization, select Register Webhooks to create the subscriptions in Shopify. Zenoti reports Error in register subscription if Shopify rejects them.

Authorize the Zenoti app in Shopify

The Authorize panel explains the Authorization Process:

  1. Click Authorize Now to enter Shopify login page.
  2. Login with your Shopify account and password.
  3. Click Install unlisted app to agree authorization.
  4. Page redirects to Zenoti with a success message.

Select Authorize Now and follow those steps. The callback page reads Your account has been authorized successfully. with a Click to Proceed link back to the accordion. Select Register Scripts afterwards if your store uses Zenoti's storefront scripts. Until the store is authorized, the sync panels show Authorize now to proceed with manual sync and similar messages.


Map locations and payment gateways

  1. Open Locations. The grid pairs each Zenoti center CODE and CENTER with a Shopify LOCATION; map the default center at least (Map the dedicated center on Zenoti to the location setup on Shopify), then select Save. Zenoti asks you to Map locations and proceed with product sync before products can be pulled. The panel also offers Login as Admin and Visit Store links to your Shopify store.
  2. Open Payments Mapping. Enter a Shopify Payment Gateway name (presets include Bank Deposit, Cash on Delivery (COD), Money Order, and Buy now, pay later with Klarna), choose the Zenoti payment method for it, and select Add. The grid shows ECOMMERCE PAYMENT METHOD against ZENOTI PAYMENT METHOD. Zenoti rejects a duplicate gateway (Same Gateway already exists) and an empty row (Please enter the Gateway details). Gateways that are not mapped fall back to Default Custom Payment.

If a mapped Zenoti payment is later removed, the panel warns Configured payment for <gateway> was removed from the System. Verify the mapping and save the payments with a Map Payment Now link.


Map marketplace orders

With Enable Marketplace Order Mapping on, open Marketplace Order Mapping to decide which guest record receives orders that arrive from a marketplace channel.

  1. Select Add Mapping.
  2. Enter the marketplace SOURCE NAME (the value Shopify sends as source_name), and the GUEST FIRST NAME, GUEST LAST NAME, and GUEST EMAIL of the Zenoti guest the orders are booked under. Turn on ACTIVE.
  3. Select Save. Zenoti rejects duplicates (Duplicate source name, Duplicate email) and bad emails (Invalid email format).

The panel notes that Shopify does not share end-customer PII for marketplace orders, which is why a placeholder guest is needed.


Run the first sync and schedule the jobs

The Manual Sync panel opens with the note that the following actions must be done at the time of the initial integration.

  1. Locations: select Get to pull Shopify locations (Locations have been Synced).
  2. Products: select Post to push Zenoti products to Shopify, or pull Shopify products into the default center's inventory, mapped by SKU (Products have been Synced).
  3. Sale Orders: pick a date in Choose a date and select Get to import that day's orders (Sale Orders have been Synced). Zenoti requires a date: Select a valid date to sync.
  4. Inventory Levels: select Sync to align Shopify stock with the default center (Inventory levels have been Synced).
  5. Customers: select Get to import Shopify customers, matched to Zenoti guests by email.
  6. Gift Cards (with Enable Gift Cards on): post Sales, Redemptions/Adjustments, Update Expiry Date, and Refunds for a chosen date, or select Migrate under Gift Card Migration to push every active Zenoti gift card with its balance as of yesterday.

Then open Sync Schedule, choose a job in Select Job under Schedule Jobs (for example Get Sale Orders, Get Inventory Level, Set Inventory Level, Get Customers, Post GiftCards), add it, and set its interval. The grid shows JOB, LAST RUN TIME, SYNC DATE, NEXT RUN TIME, SCHEDULE, STATUS, ORDER, and RUN STATUS. Zenoti confirms with Job has been added successfully and refuses duplicates with Job has been added already.


Reconnect after the token expires

If the Zenoti app is uninstalled from Shopify or Shopify revokes the token, the accordion shows Your Shopify token is no longer valid. Click Reset and then click Authorize Now to reconnect.

  1. Open Authorize and select Reset. Its tooltip reads Clears the token and makes Authorize Now option available.
  2. Select Authorize Now and complete the Shopify steps again.
  3. Select Register Webhooks in Subscriptions so the subscriptions exist for the new install.

Uninstall removes the app connection entirely; Zenoti asks Do you really want to uninstall Shopify? This will cause the Shopify integration to stop immediately.


Verify the integration

  1. Open Shop and confirm the store details Zenoti reads from Shopify: Shop Name, Owner, Phone, Email, Domain, Shopify Plan, TimeZone, Price Includes Tax, Is Shipping Taxed, and Multi Locations Enabled.
  2. In Shopify, create a test order for a low-value product with a test customer.
  3. Import the day with Get on Sale Orders, or wait for the scheduled job, and confirm a matching invoice appears in the default center with the guest, product, and total carried over.
  4. Void or refund the test invoice, then cancel or archive the test order in Shopify.

If any step fails, see Troubleshooting and Sync Shopify orders and products.


What to configure next

Required:

Recommended:


Tips

  • Use consistent SKUs between Zenoti and Shopify from day one; Zenoti maps products by SKU.
  • Consolidate multiple Shopify stores into one before connecting. Zenoti supports exactly one store per organization.
  • Do not uninstall the Zenoti app from Shopify unless you intend to disconnect; uninstalling invalidates the token and stops new orders from syncing.
  • If you rotate the Multipass secret in Shopify Plus, update Multipass Secret in Zenoti immediately; otherwise Webstore SSO breaks for all guests.
  • Set Sync Start Date to the day your store goes live in Zenoti. An earlier date imports historical orders that may have no matching Zenoti records.

Troubleshooting

Symptom Likely cause Resolution
Panels show Configure settings to authorize The Configuration panel has not been saved. Complete and save Configuration.
Authorize Now returns to Zenoti without the success message. The signed-in Shopify user cannot install an unlisted app, or the store URL or API credentials are wrong. Sign in to Shopify as an admin, check Store URL, API KEY, and API SECRET KEY, then retry.
Your Shopify token is no longer valid. Click Reset and then click Authorize Now to reconnect The app was uninstalled from Shopify or the token was revoked. Follow Reconnect after the token expires.
Map locations and proceed with product sync No center is mapped to a Shopify location. Map the default center in Locations.
Orders import with the default custom payment instead of the real gateway. The gateway is not mapped. Add it in Payments Mapping.
Multipass SSO does not sign the guest in on Shopify Plus. Multipass Secret in Zenoti does not match Shopify, or the guest does not exist on the Shopify side yet. Re-copy the secret from Shopify Plus admin and save.
Webhook events never arrive. Subscriptions were not registered after (re)authorization. Select Register Webhooks in Subscriptions.

Was this article helpful?
Your feedback helps us improve our documentation.