🚀 Guide: Connecting Zuzana to Your Shopify Store

Follow this step-by-step tutorial to create a secure, custom connection between your Shopify store and Zuzana. This process ensures your data remains private and your integration is optimized for performance. FYI: Keep in mind that has to be done by a Shopify Admin.

Phase 1: Create Your App

The first step is to register a new application within the Shopify developer ecosystem.

1. Access the Dashboard: Go to the Shopify Dev Dashboard.
2. Start Creation: Click the Create app button in the top-right corner.
3. Choose Integration Type: On the selection screen, choose Start from Dev Dashboard. This is the standard method for private, custom integrations.
4. Name Your App: In the "App name" field, enter Zuzana. Click Create to proceed.

Phase 2: Configure Permissions & URLs

Now you must tell Shopify exactly what data Zuzana is allowed to access and where to send it.

1. Navigate to Versions: From your app's home screen, click the Versions or Configuration tab.
2. Create a New Version: Click Create version.
3. Specify App name: Put "Zuzana" or something (not really important). 
4. In URLs section: 
   1. Copy & paste this App URL: https://app.zuzana.ai/shopify/oauth/install
   2. Uncheck "Embed app in Shopify admin"

1. Scroll down to Access section. In the Scopes text area, copy and paste the following permissions exactly:

2. write_orders, read_products, write_returns, write_customers, write_merchant_managed_fulfillment_orders

3. Configure Redirect URLs:
   • Copy & paste: https://app.zuzana.ai/shopify/oauth/callback
4. Finalize Version: Scroll down and click Create version. You should see a confirmation that "Version 1.0" (or similar) has been successfully created.

Phase 3: Release & Install

1. Release the Configuration: On the version history page, click the Release button next to your newest version.
2. Confirm Release: A prompt will appear; select Release this new version. This activates your settings.
3. Initiate Installation: Go back to the Home/Overview tab of your app.
4. Install to Store: Click the large Install app button.
5. Authorize: Select your Shopify store from the list and click Install on the Shopify Admin authorization page.

Phase 4: Keys

1. The next step is to go to the Zuzana platform and create a new Shopify Store integration. Put in your Shopify domain (eg. the XXXX.myshopify.com domain).
2. Then go back to your Shopify Dev Dashboard and go to your app's settings. Find the App's Client ID & Secret, and copy-paste them into Zuzana.
3. You're done! 💪

FYI: If you have multiple Shopify stores, you only need one Zuzana Shopify Custom app - but you need to install this app on all of the stores you'd like to connect with Zuzana.