This integration is completely free of cost.
Watch and follow along the tutorial below to set up your Shopify integration.
(Feel free to pause the video at any step!)
Features:
Sync Airgoods orders on your Shopify
Direct import products from Shopify into Airgoods
Real-time pricing sync
Real time inventory sync
Import Airgoods sample orders to Shopify
Visibility into which orders and products are linked to Shopify
If you have any questions, feel free to reach out via our live chat on airgoods.com or email us at [email protected].
Scopes for the Shopify app:
read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_companies,write_companies,read_custom_fulfillment_services,write_custom_fulfillment_services,read_customers,write_customers,read_price_rules,write_price_rules,read_discounts,write_discounts,write_draft_orders,read_draft_orders,read_fulfillment_constraint_rules,write_fulfillment_constraint_rules,read_fulfillments,write_fulfillments,write_inventory,read_inventory,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,write_locations,read_locations,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,write_order_edits,read_order_edits,read_orders,write_orders,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,read_publications,write_publications,write_resource_feedbacks,read_shipping,write_shipping,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders
Part 1: Pre-integration (Optional)
Upload your products to Airgoods
Add SKU information to Airgoods products
Make sure every product in Airgoods has the "SKU" column filled in. It needs to match exactly with the products in Shopify. This is helpful because it will allow you to automatically link these products to Shopify by SKU.
(Tip) You can bulk edit your products on Airgoods by going to the Products tab
Add shipping rates to Airgoods
Make sure you set a shipping rate that is NOT “Added after shipped”. Wholesale buyers prefer getting a guaranteed shipping rate upfront so that they can calculate their landed costs and this has been seen to be correlated with more sales.
If you have “Added after shipped” as your default shipping setting, you will need to manually enter tracking information and shipping cost to mark orders as fulfilled, we won't be able to automatically pull tracking information from Shopify.
Step 2: Integration & Shopify App Creation
Generate API keys on Shopify
Open your Shopify and go to your Settings (bottom left).
Go to Apps, then click Develop apps.
Click the Build apps button (top right), then select Create app.
Name your app (e.g., "Airgoods") and click Create.
In the app settings, enter the Airgoods app URL (https://airgoods.com).
Uncheck Embed app in Shopify admin.
Copy and paste the required scopes from the setup guide into the scopes box.
Scopes:
read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_companies,write_companies,read_custom_fulfillment_services,write_custom_fulfillment_services,read_customers,write_customers,read_price_rules,write_price_rules,read_discounts,write_discounts,write_draft_orders,read_draft_orders,read_fulfillment_constraint_rules,write_fulfillment_constraint_rules,read_fulfillments,write_fulfillments,write_inventory,read_inventory,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,write_locations,read_locations,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,write_order_edits,read_order_edits,read_orders,write_orders,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,read_publications,write_publications,write_resource_feedbacks,read_shipping,write_shipping,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders
Click Release and then confirm clicking on release again.
(Optional) Upload the Airgoods icon for a custom app logo, as described in the setup guide.
Click on the app name ("Airgoods") in the top left-hand menu, then click Install app on the right. Select and log into your Shopify account and confirm the installation.
Important: This is a required step. The integration will not work until the app has been installed on your Shopify store.
After downloading the app return to the app settings to view your Client ID and Client Secret.
Copy each, then paste into the corresponding fields back on Airgoods. Ensure there are no leading or trailing spaces when copying the Client ID and Client Secret to avoid errors.
Find your Shopify store subdomain (everything before .myshopify.com) and enter it in Airgoods.
You can find your subdomain by going to Settings → Domains in Shopify. Keep in mind that your Shopify subdomain is not the same as your custom domain (e.g., yourbrand.com).
Important: Enter only the subdomain, without extra characters, spaces, or the full domain, as this can cause connection issues. For example, if your Shopify URL is acme-store.myshopify.com, enter acme-store.
On Airgoods, click Connect. If successful, you’ll move to the integration settings.
Step 3: Integration settings and linking products
Toggle settings according to your needs:
Order Syncing: Keep this on to push orders from Airgoods into Shopify.
Inventory Syncing: Turns this on to keep inventory synced across products on Shopify and Airgoods. Products will be marked as OOS when inventory = 0 on Shopify.
Pricing Sync: Sync product pricing across platforms.
Important: Choose how Airgoods orders should be imported into Shopify:
Cases: Each case ordered on Airgoods imports as a quantity of 1 in Shopify.
Individual Units: Each case ordered on Airgoods imports as the number of units contained in that case.
For example, if a product has 6 units per case and a retailer orders 1 case:
Cases: Shopify imports a quantity of 1
Individual Units: Shopify imports a quantity of 6
Optional:
Add custom order tags, like “Airgoods” or “Wholesale,” to help identify imported orders.
Set up order number customization if you prefer custom order numbers when importing to Shopify.
Scroll up and click Link Products to match Airgoods products with Shopify products.
If SKUs match, use Link Automatically.
If not, link manually by clinking on "Link" and selecting products manually.
Success!
Step 4: Test the Integration
Once your products are linked, test the integration to ensure everything is working correctly.
In your integration settings, click Create Test Order.
Open the test order in Airgoods, choose a ship date, and Accept Order.
Accepting the order in Airgoods will trigger the integration and automatically import the order into Shopify.
Check Shopify to confirm that:
The order imported successfully.
The correct products were included.
Any expected tags were applied.
Once you've confirmed the order imported correctly, cancel the test order. Do not fulfill or ship the test order.
Adding New Products
If you add a new product in Shopify after completing the integration, you'll also need to add it to Airgoods and complete the Product Sync process to ensure it is linked to the correct Shopify product.
Final Steps and Recommendations
Orders pulled into Shopify require acceptance first in Airgoods.
If shipping rates are "Added after shipped" in Airgoods, you’ll need to manually enter tracking info and shipping cost. To avoid this, set fixed or free shipping rates for streamlined fulfillment.
Once setup is complete, your products, orders, inventory, and (optionally) prices will sync between and Shopify, minimizing manual work.
Step 5: Troubleshooting Common Setup Issues
Common Causes of Shopify Integration Failures:
Incorrect Input Fields
Make sure your Shopify subdomain is entered correctly (e.g.,
storename.myshopify.com).Do not use your custom website domain (e.g.,
www.yourstore.com), as this is different from your Shopify subdomain.You can find your Shopify subdomain by going to Shopify Admin → Settings → Domains.
Verify that the Client ID and Client Secret are copied exactly from your custom app settings, with no extra spaces before or after the values.
Missing or Incorrect Shopify Scopes
Ensure your custom app has all required scopes enabled.
Missing permissions can prevent the integration from connecting successfully.
Double-check that you copied and pasted the scopes exactly as outlined in the setup instructions above.
App Not Installed
After creating your custom app in Shopify, make sure you install the app from your Shopify Dev dashboard before attempting to connect it to Airgoods.
If the app is not installed, the integration will fail.
Missing Permissions to Create Apps
If you do not see the "Develop Apps" option in Shopify, your account likely does not have permission to create custom apps.
Contact your Shopify store administrator and ask them to grant the required permissions or create the app on your behalf.
General Setup Errors
Errors such as "Connection Failed" are usually caused by incorrect credentials, missing scopes, or skipped setup steps.
Review each step carefully and ensure all required information has been entered correctly.
Step-by-Step Troubleshooting Guide
Verify Input Fields:
Double-check the Shopify store domain (e.g., [STORE].myshopify.com), Client ID, and Client Secret for accuracy. Remove any extra spaces or characters.
Reconnect the Integration:
Disconnect the Shopify app from Airgoods and reconnect it by following the step-by-step guide.
Restart the Setup Process:
Retry the setup from the beginning (creating the app), ensuring all steps are followed carefully.
Advanced Troubleshooting Tips
If the integration still fails, note the exact step where the error occurs and capture a screenshot of the error message. This information can help in further troubleshooting. By following these steps, most Shopify integration issues in Airgoods can be resolved effectively. If you encounter issues during integration, refer to the troubleshooting section above for common causes and solutions.
If you have questions or run into issues, contact our support team at [email protected] ! We are happy to help! For detailed troubleshooting steps, see the "Troubleshooting Common Issues" section above.