This article shows you how to connect WooCommerce to HexaSync, from preparing the connection details and authorizing access to creating the WooCommerce Connector App and checking product and inventory data. You will also learn how to re-authorize the connection and fix common errors. Setting up this connection is a required step when you start integrating WooCommerce with Microsoft Dynamics 365 Finance or other systems.
Before you start
- A Beehexa account. If you do not have one yet, sign up on the same page.
- A WordPress admin account for the store (Administrator or Shop Manager) to create the REST API key.
- The store URL, for example
https://example.com. The store needs WooCommerce 5.8 or later, and Settings › Permalinks in WordPress must not be set to Plain. - A browser that is not signed in to the store’s WordPress admin (wp-admin), or a private window. If you are signed in, WordPress may reject HexaSync when it sets up the webhooks.
Note: The WooCommerce Connector App connects with the store URL and the REST API key pair (Consumer Key and Consumer Secret) generated by WooCommerce.
Part 1: Authorize the WooCommerce connection on HexaSync
Step 1: Sign in to HexaSync
- Sign in with your Beehexa account at HexaSync Automation Engine.
Step 2: Start the WooCommerce connection
- Open the WooCommerce connection setup page on HexaSync.
- On the Check connection details screen, select Connect in the WooCommerce row.
Step 3: Create a REST API key in WooCommerce
- Open the store’s WordPress admin, go to WooCommerce › Settings › Advanced › REST API and select Add key.
- Fill in Description: HexaSync; User: the admin account; Permissions: Read/Write. Select Generate API key.
- Copy the Consumer key and Consumer secret.
Note: WooCommerce shows the Consumer secret only once, so keep this page open until you have pasted it into HexaSync.
Select Read/Write to prepare for integrating WooCommerce with another system through HexaSync. If you do not need this, you can Edit the key and change it to Read; the Consumer key and Consumer secret stay the same.
Step 4: Enter the details and confirm
- Go back to the Connect HexaSync to your WooCommerce store screen on HexaSync.
- Enter the Store URL (the store address) and the Consumer Key and Consumer Secret you just copied, then select Submit.
- HexaSync checks the key against the store and stores it in encrypted form. If an error appears, see Part 4.
Step 5: Choose the events sent to HexaSync
- On the Choose The WooCommerce Events HexaSync Receives screen, keep product.created and product.updated selected so that inventory is updated as soon as it changes. Clear the events you do not need, then select Submit.
- HexaSync creates a webhook on the store for each selected event. When the Your Store’s Webhooks Are Ready screen appears, select Continue.
- When WooCommerce has the status Connected, select Create WooCommerce Connector.
Step 6: Name the WooCommerce Connector App
- On the Enter Connector App Name screen, HexaSync suggests a Connector App name that includes the store name taken from the store URL. For example, the store hexasync-demo.com gets the suggested name [Hexasync-demo] WooCommerce Connector. Edit the name if needed.
- Check the text in the Description field, then select Submit.
- The setup takes a few minutes. Stay on the page during this time.
Step 7: Finish the WooCommerce Connector App
- After the setup, the system takes you to the WooCommerce Connector App you just created. The Connector App has Tasks that retrieve the product list and the inventory of each product variation from WooCommerce.
- You can review the Connector App in Connector Apps.
- Next, check the connection and the data by following Part 3.
Part 2: Re-authorize the WooCommerce connection
You need to re-authorize when:
- The REST API key is revoked or changed.
- You need to change the events sent to HexaSync.
- Inventory stops updating in real time.
Before you start, turn off the automatic schedules in the Connector App. Update the connection row that is in use; do not create a new Connector App or connection to fix an access error.
Step 1: Prepare the REST API key
- Use the current key if it is still valid. If the key has been revoked or you no longer have the Consumer secret, create a new key by following Step 3 in Part 1.
Step 2: Open the Connector App Settings
- Open the WooCommerce Connector App in Connector Apps and select Settings → Integration Apps & Credentials.
Step 3: Select Re-authorize
- Find the WooCommerce row and select Re-authorize.
- Read the text on the screen and select Continue.
Step 4: Enter the key and choose the events again
- Check the Store URL and Consumer Key, enter the Consumer Secret again, then select Submit.
- Choose the events again on the Choose The WooCommerce Events HexaSync Receives screen and select Submit.
- Wait for the success message, then check by following Part 3 before you turn the schedules back on.
Note: Each time you re-authorize, HexaSync creates a new webhook secret, updates the HexaSync webhooks on the store and reactivates the WooCommerce webhooks that were paused. If you added webhooks by hand, update their Secret field as shown on the instruction screen.
Part 3: Check the connection and data
Step 1: Check the connection details
Open the Connector App and go to Settings → Integration Apps & Credentials:
- WooCommerce has the status Connected.
- The HexaSync Connector has been created.
In the WordPress admin, go to WooCommerce › Settings › Advanced › Webhooks and check that the webhooks named HexaSync product.updated (and the other events you chose) have the status Active.
Step 2: Check the data
- In the Task list, open a Task to check the data. Wait for the first data retrieval run to finish; a store with many products can take a few minutes.
- Check the data in each Task:
- [WooCommerce] Products: SKU, product name, product type (simple, variable) and the time of the last update.
- [WooCommerce] Product Stock: the stock quantity (
stock_quantity) and stock status (stock_status) of each product variation, and of simple products that have stock management turned on.
- Compare with WooCommerce. Expected result: every variation with Manage stock? turned on has one row, and the stock quantity matches WooCommerce.
You can change the stock quantity of a variation in WooCommerce, then check that its row in the [WooCommerce] Product Stock Task is updated after a few seconds.
Step 3: Check before you turn on automatic runs
- Check that it is the right store (Store URL).
- Run one task that retrieves data from WooCommerce (Pull) as a test and compare a few variations with WooCommerce.
- Turn the automatic schedules on, or back on, only after all the tasks you need have succeeded and the results are correct.
If you do not know which task to choose or run, ask Beehexa to help you check in the Connector App that is in use.
Part 4: Common errors and how to fix them
| Message | How to fix |
|---|---|
| HexaSync Could Not Verify Your WooCommerce Key | HexaSync could not verify the store URL or the key. Check that the Store URL matches Settings › General › Site Address, the Consumer key starts with ck_, the Consumer secret starts with cs_, the key has not been revoked, and Settings › Permalinks is not set to Plain. Select Fix my store details and try again. |
| HexaSync Could Not Read Your Store’s Webhooks | The key is connected, but the browser could not set up the webhooks. Sign out of the WordPress admin (or use a private window) and try again; check that the key has Read/Write permission and belongs to an Administrator or Shop Manager account. If a security plugin or firewall blocks /wp-json/, allow HexaSync or add the webhooks by hand. |
| Some Webhooks Could Not Be Registered | Some webhooks could not be created. Select Try again; HexaSync only redoes the missing part. If the error persists, select Skip — I will add the webhooks in WordPress admin myself. |
| Add The Webhooks In WordPress Admin | Go to WooCommerce › Settings › Advanced › Webhooks → Add webhook and add one webhook for each event: Name is HexaSync followed by the event name; Status Active; Topic is the event, for example Product updated; Delivery URL and Secret copied exactly from the HexaSync screen; keep API Version as WP REST API Integration v3; select Save webhook. |
| Inventory stops updating in real time | WooCommerce turns off a webhook after 5 failed deliveries in a row. Re-authorize by following Part 2 to turn it back on. In the meantime, inventory is still retrieved on the schedule, about every 15 minutes. |
| Authorized, but the data is incorrect or has not appeared | A variation without Manage stock? turned on uses the parent product’s stock, so it has no row of its own in Product Stock. Check the WooCommerce version (5.8 or later) and the task run results. Keep the schedules off while the data is incorrect. If the error persists, contact support@beehexa.com. |
Part 5: Protect your details and stop the connection
Security note: Enter the Consumer Key and Consumer Secret directly on the HexaSync authorization screen. Do not put these details, or the webhook secret, in chat groups, regular email or error screenshots.
To stop the connection:
- Ask Beehexa to turn off the schedules and disconnect in HexaSync.
- The store administrator revokes the HexaSync key at WooCommerce › Settings › Advanced › REST API → Revoke.
- Delete the webhooks named HexaSync in WooCommerce › Settings › Advanced › Webhooks.
Turning off the schedules does not mean access has been revoked. Stopping the connection does not delete the data that has already been synced.
Part 6: Information to send Beehexa when you need support
- The store URL, the Connector App name and the connection type: WooCommerce.
- The step you were on, when the error happened, the error message and the Technical details if available.
- The WooCommerce version, the security plugins in use, and recent changes to the REST API key or webhooks.
Screenshots must hide the Consumer Key, Consumer Secret, webhook secret and sensitive data. Contact the Beehexa contact who supports your business, or support@beehexa.com. See also the Beehexa Privacy Policy and the Beehexa Support Policy.
Frequently asked questions
How do I connect WooCommerce on HexaSync?
The process has seven steps: sign in to HexaSync, open the setup page and select Connect, create a REST API key in WooCommerce, enter the store URL and the key, choose the events sent to HexaSync, name the Connector App, then open the Connector App to check it.
Where do I get the Consumer Key and Consumer Secret?
In the WordPress admin, go to WooCommerce › Settings › Advanced › REST API and select Add key with Read/Write permission. The Consumer secret is shown only once; if you have closed the page, create a new key.
What data does HexaSync retrieve from WooCommerce?
The WooCommerce Connector App retrieves the product list and the inventory of each product variation, plus the inventory of simple products that have stock management turned on.
Does HexaSync write or change data on WooCommerce?
It does not change products, inventory or orders. HexaSync only creates, activates or pauses the webhooks named HexaSync on the store; this is why the REST API key needs Read/Write permission. Read/Write permission also prepares for integrating WooCommerce with another system through HexaSync. If you do not need this, you can Edit the key and change it to Read; the Consumer key and Consumer secret stay the same.
How soon is inventory updated on HexaSync?
A few seconds after inventory changes on WooCommerce, through webhooks. The data retrieval schedule also runs about every 15 minutes to catch changes that the webhooks missed.