Skip to main content

Airgoods WooCommerce Integration Guide

Step-by-step guide for sellers to connect their WooCommerce store to Airgoods and sync orders, products, inventory, and pricing.

This integration is completely free of cost.

Connect your WooCommerce store to Airgoods to keep orders, products, inventory, and pricing in sync — without copying anything by hand.

Features:

  • Sync Airgoods orders into WooCommerce

  • Real-time pricing sync

  • Real-time inventory sync

  • See at a glance which orders and products are linked to WooCommerce

What you'll need before starting:

If you have any questions, feel free to reach out via our live chat on airgoods.com or email us at [email protected].

Part 1: Before you connect (optional, but recommended)

  • Upload your products to Airgoods

  • Add SKUs to your Airgoods products

Make sure every product in Airgoods has the "SKU" field filled in, and that it matches the SKU in WooCommerce exactly. This lets Airgoods link your products automatically instead of one at a time.

(Tip) You can bulk edit your products from 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 stores with upfront rates tend to sell more.

If your default shipping setting is "Added after shipped," you'll need to enter tracking information and shipping cost manually to mark orders as fulfilled — we won't be able to pull tracking from WooCommerce automatically.

Part 2: Create your WooCommerce API key

Airgoods connects to WooCommerce using a REST API key, which is a pair of credentials WooCommerce generates for you. It takes about two minutes.

  • Log in to your WordPress admin dashboard.

  • Go to WooCommerce → Settings → Advanced → REST API.

  • Click Add key.

  • Fill in the form:

    • Description: Airgoods (this is just a label for you)

    • User: choose an administrator account (this is the user the key acts as)

    • Permissions: select Read/Write — this is required. Read-only keys will connect but orders and inventory won't sync.

  • Click Generate API key.

  • WooCommerce will show you a Consumer key and a Consumer secret. Copy both somewhere safe right now.

Important: The consumer secret is only shown once. If you leave or refresh that page before copying it, you'll need to delete the key and generate a new one.

Part 3: Connect WooCommerce on Airgoods

  • In Airgoods, go to your seller account and open the WooCommerce integration.

  • Enter the following:

    • Consumer key — the key you just copied from WooCommerce

    • Consumer secret — the secret you just copied from WooCommerce

    • Store domain — the web address of your WordPress site

  • Click Connect. If it works, you'll move straight to the integration settings.

Getting the store domain right

Enter your domain exactly as your store loads in a browser, with no extra characters:

  • ✅ yourbrand.com

  • ✅ shop.yourbrand.com (if WooCommerce runs on a subdomain)

  • https://yourbrand.com/ (no https://, no trailing slash)

  • ❌ yourbrand.com/shop (no page paths)

If WordPress lives in a subfolder (for example yourbrand.com/store), use the address you see in WordPress → Settings → General → Site Address (URL).

Ensure there are no leading or trailing spaces when copying the Consumer key and Consumer secret to avoid errors.

Part 4: Integration settings and linking products

  • Toggle settings according to your needs:

    • Order Syncing: Keep this on to push orders from Airgoods into WooCommerce.

    • Inventory Syncing: Keep this on to keep inventory synced across products on WooCommerce and Airgoods. Products will be marked as out of stock on Airgoods when inventory hits 0 in WooCommerce.

    • Pricing Sync: Sync product pricing across platforms.

  • Important: Choose how Airgoods orders should be imported into WooCommerce:

    • Cases: Each case ordered on Airgoods imports as a quantity of 1 in WooCommerce.

    • 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: WooCommerce shows a quantity of 1

      • Individual Units: WooCommerce shows 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 WooCommerce.

  • Scroll up and click Link Products to match your Airgoods products with your WooCommerce products.

    • If SKUs match, use Link Automatically.

    • If not, link manually by clicking Link and selecting the matching WooCommerce product.

Part 4: Test the Integration

Once your products are linked, test the integration to ensure everything is working correctly.

  1. In your integration settings, click Create Test Order.

  2. Open the test order in Airgoods, choose a ship date, and click Accept Order.

  3. Accepting the order in Airgoods will trigger the integration and automatically import the order into WooCommerce.

  4. Check WooCommerce to confirm that:

    • The order imported successfully.

    • The correct products were included.

    • Any expected tags were applied.

  5. 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 WooCommerce after completing the integration, you'll also need to add it to Airgoods and run Link Products again to ensure it is linked to the correct WooCommerce product.

Final Steps and Recommendations

  • Orders pulled into WooCommerce 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 Airgoods and WooCommerce, minimizing manual work.

Part 5: Troubleshooting Common Setup Issues

Invalid Credentials or Connection Failed

  • Re-copy the Consumer key and Consumer secret, checking for spaces at the start or end.

  • Confirm the key's permissions are set to Read/Write, not Read.

  • If you're not sure the secret was copied correctly, delete the key in WooCommerce and generate a new one — the secret can't be viewed again after the first time.

"404" or "Route Not Found" Errors

  • WooCommerce's API is disabled when WordPress permalinks are set to "Plain."

  • In WordPress, go to Settings → Permalinks, choose any option other than Plain (for example, Post name), and save. Then try connecting again.

Your Site is Behind a Security Plugin, Firewall, or Password

  • Security tools like Wordfence, Cloudflare, or a "coming soon"/maintenance-mode plugin can block Airgoods from reaching your store.

  • Ask whoever manages your site to allow REST API requests to /wp-json/wc/v3/. Staging sites protected by a password won't connect at all.

You Don't See the REST API Screen

  • You need an administrator account to create API keys.

  • If WooCommerce → Settings → Advanced → REST API isn't there, ask your site administrator to create the key for you, or to upgrade your role.

Products Aren't Linking

  • Automatic linking matches on SKU. Check that the SKU in Airgoods matches the SKU in WooCommerce exactly — no extra spaces, and matching capitalization.

  • Anything that doesn't match can be linked manually.

Inventory or Prices Look Out of Date

  • Syncs run in the background and can take a few minutes.

  • If a specific product never updates, check that it's actually linked on the Link Products screen.

Step-by-Step Troubleshooting Guide

Did this answer your question?