Step-by-Step Connection Process

To connect your Shopify store:

1. Navigate to /integrations and click the Shopify tab
2. Enter your Store Name (e.g., mystore.myshopify.com - include .myshopify.com)
3. Enter your Access Token from Shopify Admin
4. Enter your Webhook Secret for webhook verification
5. Select your Currency (default: USD)
6. Click "Connect Shopify" to establish the connection
7. Wait for connection confirmation

Creating Your Shopify Apps

You'll need to create at least two private apps in Shopify (main integration and pricing), plus optional speed booster apps:

1. Main Shopify Integration App (Required)

This app is used for the primary SortSwift integration and needs full permissions:

1. Log in to your Shopify Admin panel
2. Go to Settings → Apps and sales channels → Develop apps
3. Click "Create an app" and name it (e.g., "SortSwift Main")
4. Click "Configure Admin API scopes"
5. Grant ALL available permissions - this app needs full access
6. Click "Save" and then "Install app"
7. Reveal and copy your Admin API access token
8. Also copy the API secret key - this is your webhook secret

2. Shopify Pricing App (Required)

This app handles all pricing pushes for items separately from the main integration:

1. In the same Shopify admin, create a second app
2. Name it distinctly (e.g., "SortSwift Pricing")
3. Grant ALL available permissions - this app also needs full access
4. Install the app and save the access token and API secret key
5. This separates pricing updates from inventory updates for better reliability

3. Speed Booster Apps (Optional, For Rate Limit Increases)

Speed boosters allow you to bypass Shopify's API rate limits for faster syncs. These apps need limited permissions:

1. Create additional apps named "SortSwift Booster 1", "SortSwift Booster 2", etc.
2. Grant only these specific permissions:
   • read_products and write_products
   • read_inventory and write_inventory
3. Install each app and save the access tokens
4. Enter these tokens in SortSwift's Speed Booster configuration

Understanding Webhook Secret

The webhook secret is the API secret key generated when you create your Shopify app:

• Find it in your app's API credentials tab
• It's labeled as "API secret key"
• Click "Reveal" to view it
• This is what you'll enter as the webhook secret in SortSwift
• It's used to verify webhook requests are legitimate

Connection Verification

After connecting:

• Connection status will update to "Connected"
• Store name will be displayed
• You'll see sync options and settings
• Advanced location mode will be available
• You can start pushing inventory to Shopify

Troubleshooting Connection Issues

Common connection issues:

• Invalid Store Name: Ensure you include .myshopify.com and use correct format
• Invalid Access Token: Verify token is correct and has required permissions
• Permission Errors: Check that app has read/write access to products and inventory
• Connection Timeout: Check internet connection and Shopify API status
• Already Connected: You may need to disconnect first if connecting a different store