🚀 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. Set Admin API Scopes: In the Scopes text area, copy and paste the following permissions exactly:

4. read_customers, read_orders, write_orders, read_products, read_returns, write_returns

5. Configure App URLs:
   • Allowed Redirect URL: https://app.zuzana.ai/shopify/oauth/callback
   • App URL: https://app.zuzana.ai/shopify/oauth/install
6. 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 and 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 and follow the steps.
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! 💪