Get started with Packhai OMS on HexaSync

Q: When I re-authorize, which connection option should I choose?

If the current connection still works, select Use the existing connection (recommended). Only select Replace it with a new token when the old token no longer works or has been exposed.

Q: Do I need to set up the webhook in Packhai again when I re-authorize?

No, if you select Use the existing connection. If you select Replace it with a new token, you need to set up the webhook again for the new token in Packhai.

This guide explains how to connect Packhai OMS to HexaSync to pull data from Packhai OMS. This data is used to assess the quality of your inventory data, and to check the data before you connect to another system.

Before you start

A Beehexa account to sign in to HexaSync Automation Engine. If you do not have one yet, sign up on the same page.
A Packhai OMS account with shop owner permission for the shop you want to connect. Sign in at Packhai OMS.

Important: do not skip the webhook setup step. Packhai connects with a token and does not register the webhook by itself. You must paste the Webhook URL and Webhook Bearer that HexaSync provides into Packhai in Step 5. Without this step, HexaSync does not receive status updates from Packhai.

Part 1: Authorize the Packhai OMS connection on HexaSync

Go to HexaSync Automation Engine and sign in with your Beehexa account.

Step 2: Start the Packhai OMS connection

Open the Packhai OMS authorization page on HexaSync.
On the Check connection details screen, find Packhai OMS and select Connect.

Step 3: Get the token in Packhai

Sign in to Packhai OMS with the shop’s account and open the เชื่อมต่อ (Connectivity) menu in the navigation bar.
Click Create token for external connection, then click CREATE TOKEN.
In the token creation dialog, select all three required values:
- Sales Channel
- Connected warehouse
- Salesperson
Click Token Generation, then check the new token in the list.
Click the copy button to copy the whole newest token. Do not type the token by hand or cut it short.

Security note: The token does not expire, and deleting the token in Packhai does not revoke it. Keep the token secret.

Step 4: Enter the token and confirm the connection

Go back to HexaSync and paste the token into the Packhai Token field.
Select Continue. HexaSync reads the shop name and Shop ID from the token.

Step 5: Set up the webhook in Packhai

On the HexaSync screen, copy the Webhook URL and Webhook Bearer.
In Packhai, open เชื่อมต่อ (Connectivity). In the row of the token you pasted in Step 4, scroll the table to the right and click Setup in the Setup Webhooks column.
Paste the Webhook URL and Webhook Bearer into the matching fields. Paste the Webhook Bearer value exactly as it is, and do not add the word Bearer yourself.
Select SAVE. When the webhook code row appears, the webhook is set up.
Go back to HexaSync and select I have saved the webhook in Packhai — continue.

Ignore the TEST WEBHOOK URL button. This button always shows Test failed, even when the URL is correct, because the test does not send a request. Real data is still sent as normal.

Step 6: Create the Packhai OMS Connector App

Click Create Packhai OMS Connector.
HexaSync names the Connector App in the form [Shop name] Packhai OMS Connector. Check the details and click Continue. The screen moves to the Connector App automatically when it is done.

Step 7: Check the Connector App on HexaSync

Check the connection details

Open Connector Apps and select the Packhai OMS Connector App you just created.
In Settings, confirm that Packhai OMS has the status Connected.

Check the data

Open the Inventory task in the Connector App.
Compare a few products and their stock quantities with the data in Packhai.

Part 2: Re-authorize the Packhai OMS connection on HexaSync

You need to re-authorize when:

The old token no longer works.
You suspect the token has been exposed.
Beehexa asks you to re-authorize.

Before you start, turn off the automatic schedule in the Connector App. Update the connection details on the Connector App you are using. Do not create a new Connector App just to fix a connection error.

Step 1: Select Re-authorize on HexaSync

Open the Packhai OMS Connector App in Connector Apps.
Go to Settings, find the Packhai OMS row and select Re-authorize.
On the shop selection screen, the connected shop is already selected. Keep it and click Continue.

Cannot use Re-authorize? Only the owner (creator) of the Packhai OMS Connector App has permission to re-authorize. If you are not the owner, HexaSync shows the error HexaSync Could Not Register Your Packhai Shop. Contact the owner of the Connector App so they can use Re-authorize.

Step 2: Choose how to reconnect

The This Packhai shop is already connected screen has two options:

Use the existing connection (recommended): keeps the current token. Choose this option if the connection still works. Select Continue, then go to Step 5.
Replace it with a new token: choose this option only when the old token no longer works or has been exposed. Select Continue, then follow the steps in order from Step 3.

Step 3: Create and paste a new token

Do this step only if you selected Replace it with a new token.
Create a new token for the shop you want to reconnect, in the same way as Step 3 in Part 1, then paste the token into HexaSync by following the instructions on the screen.

Step 4: Set up the webhook for the new token

Do this step only if you selected Replace it with a new token.
Copy the Webhook URL and Webhook Bearer on the HexaSync screen, then paste them into the Setup Webhooks section of the new token in Packhai, in the same way as Step 5 in Part 1.

Step 5: Check and turn the schedule back on

Wait for HexaSync to report that the connection is successful.
Open the Packhai OMS Connector App, go to Settings and confirm that Packhai OMS has the status Connected.
Open the inventory task and compare a few products with the stock quantities in Packhai.
Turn the automatic schedule back on in the Connector App.

Part 3: Common errors and how to fix them

Message	How to fix it
HexaSync Could Not Register Your Packhai Shop (on the first connection)	Copy the whole token again in Connectivity, with no spaces or line breaks, then click Back to the token. If the shop already belongs to another account, ask that person to share the shop with you.
HexaSync Could Not Register Your Packhai Shop (when you re-authorize)	Your account is not the owner of the Packhai OMS Connector App, so it does not have permission to use Re-authorize. Contact the owner of the Connector App that needs re-authorizing so they can do it.
HexaSync Could Not Connect Your Packhai Token	The token belongs to a different shop from the one selected, or it was not copied in full. Create a new token in the right shop, then click Fix my token and try again.
HexaSync Could Not Give You The Packhai Webhook Details	The connection still works and inventory still syncs. Click Continue.
HexaSync Could Not Link The Credential To Your Connector App	Click Go to Manage Credentials and assign the connection to the Connector App, or contact support@beehexa.com.

For other cases, send a screenshot (with the token and sensitive information hidden) to support@beehexa.com.

Frequently asked questions

Does the Packhai token expire?

No. The token does not expire and does not need to be refreshed. Deleting the token in Packhai does not revoke a token that was already created, so keep the token secret.

When I re-authorize, which connection option should I choose?

If the current connection still works, select Use the existing connection (recommended). Only select Replace it with a new token when the old token no longer works or has been exposed.

Do I need to set up the webhook in Packhai again when I re-authorize?

No, if you select Use the existing connection. If you select Replace it with a new token, you need to set up the webhook again for the new token in Packhai.

Does HexaSync write or change data in Packhai OMS?

No. HexaSync only reads data and does not change anything in Packhai OMS.