ZenotiHelp

E-Commerce Provider: Shopify

ZTZenoti Docs Team Updated September 5, 2026 4 min readGuide

The Shopify integration connects your Zenoti organization to your Shopify store, enabling order retrieval, payment posting, and product and gift card sync between the two platforms. This article explains how to connect Shopify to Zenoti and manage the integration at the organization or center level.

Audience: Organization administrators who manage e-commerce integrations.

Before you begin

  • The Shopify connection is configured on the ECommerce accordion of Configuration > Integrations > Integration settings. The accordion renders at organization scope and, for a center-specific connection, at center scope (row Integration Settings).
  • You need administrator access to both your Zenoti organization and your Shopify store.
  • Prepare your Shopify store URL and ensure you have permission to install apps in your Shopify admin.

Permission: You need administrator-level access in Zenoti to configure integration settings. Admin path: Configuration > Integrations > Integration settings

Steps

Connect Shopify to Zenoti

  1. In Zenoti, navigate to Configuration > Integrations > Integration settings.
  2. On the Integration settings page, expand the ECommerce accordion.
  3. Work at the scope the connection should apply to: at organization scope the connection applies to all centers in your organization; to connect a single center, select that center in the scope selector first and open the accordion on Configuration > Integrations > Integration Settings.
  4. In Authorize, select Authorize Now to begin the connection process.
    • Zenoti redirects you to Shopify to complete authorization. Sign in to your Shopify account if prompted and grant the requested permissions.
    • After you approve access, Shopify redirects you back to Zenoti and the connection status updates.
  5. If the token has expired or you need to reconnect, select Reset (its tooltip reads Clears the token and makes Authorize Now option available), then Authorize Now again.

Configure REST and GraphQL API versions

After connecting, you can configure the API versions Zenoti uses to communicate with Shopify.

  1. On the Shopify accordion in Integration settings, locate the API version settings.
  2. Set the REST API version to the version your Shopify store supports.
  3. Set the GraphQL API version independently if your workflows require a different version.
  4. Select Save to apply your changes.

Note: REST API and GraphQL API versions are configured independently. Changing one does not affect the other.

Enable the gift card feature

Zenoti can sync gift card data with Shopify when the gift card feature flag is active.

  1. On the Shopify accordion in Integration settings, locate the gift card option.
  2. Select the checkbox or toggle to enable gift card sync.
  3. Select Save.

Note: Enabling gift card sync allows Zenoti to process gift card orders retrieved from Shopify. Ensure your Shopify store has gift cards configured before enabling this option.

Verify the connection

After saving your settings, confirm the integration is active.

  1. On the Shopify accordion, review the authorization status indicator.
    • A valid token shows an active or authorized status.
    • An expired or missing token prompts you to re-authorize.
  2. If the status does not update as expected, select Reset and then Authorize Now to complete the Shopify authorization flow again.

Sync orders, products, and webhooks

Once connected, Zenoti automatically processes the following data from Shopify:

  • Orders — Zenoti retrieves orders from Shopify and posts payments against the corresponding invoices.
  • Products — Product and inventory data syncs between Zenoti and Shopify.
  • Gift cards — Gift card orders are retrieved and processed when the gift card feature is enabled.
  • Webhooks — Zenoti registers webhooks with Shopify to receive real-time event notifications. Webhook configuration and event details are managed separately.

Note: For webhook event configuration and payload details, see the Zenoti APIs category.

To check the status of sync operations, use the ECommerce Sync report. The report shows sync status values including Pending, Synced, and Failed for items such as sale orders, refunds, gift cards, and product inventory levels.

Tips

  • If you manage multiple centers, decide whether to configure the integration at the organization level (applies to all centers) or at the center level (applies to one center). Center-level settings inherit from the organization if not explicitly set.
  • Use the Refresh option in the ECommerce Sync report to update the displayed sync status without navigating away from the page.
  • If authorization fails, verify that your Shopify account has app installation permissions and that your store URL is correct before retrying.

Troubleshooting

Symptom Likely cause Resolution
Authorization redirects back to Zenoti with an error Shopify app permissions were not granted Repeat the authorization flow and accept all requested permissions in Shopify
Sync status shows Failed for orders Connection token has expired Select Reset and then Authorize Now on the ECommerce accordion and complete the authorization flow
Gift card orders are not appearing in Zenoti Gift card feature flag is not enabled Enable the gift card option in the Shopify accordion and select Save
Was this article helpful?
Your feedback helps us improve our documentation.