Articles in this section

Troubleshooting Guide: WooCommerce and ShipHero

Follow this troubleshooting guide to resolve common errors with WooCommerce.

ERROR: Unable to connect. Please check your credentials, site url, and make sure your woocommerce site is compatible with API Version 3

If you try to connect to your WooCommerce site and you get this error, you will need to check your API credentials.

Go to WooCommerce > Settings > Advance > REST API to check your Credentials on your Site.

3_8f7c6652-683d-484d-8b45-2e99bf2ac258.png

4_2a748ece-0686-44e2-ac47-4fa3e27e09b2.png

5_80b87270-f55b-45f9-aee0-b647cad19be1.png

Click on the account that you need to check. Select the View/Edit link.

6_4c3342b8-b700-41bf-a344-157422bdb336.png

This takes you to Key Details. This is where the Credentials (consumer and secret keys) are stored. Ensure that the Permissions are set to Read/Write.

7_807101b4-b230-4ad6-9e16-5bca666267d0.png

Confirm that your other settings are properly configured:

  • Site URL: Copy and paste your exact website URL. Redirections are not allowed; you need to enter the final URL for your site. Make sure that if your site is using HTTPS, your URL also starts with "https://".
  • API Version: We support API version 3. If you are using an older version, contact ShipHero support to verify whether your site supports API Version 3.
  • Check the following URL: [yoursite]/wp-json/wc/v3. For example, if the URL of your site is https://woocommerce.shiphero.xyz, you can verify the API version 3 support with the URL http://woocommerce.shiphero.xyz/wp-json/wc/v3If you receive a response, you are good to go.

ERROR: Error removing webhooks, please manually remove the ShipHero webhooks in your WooCommerce store and try again.

Depending on the configuration of the WooCommerce site, we cannot remove Shiphero webhooks automatically. This needs to be done manually from your WooCommerce site. In order to remove a webhook:

  • Go to WooCommerce (tab) > Settings > Advanced > Webhooks 

3_8f7c6652-683d-484d-8b45-2e99bf2ac258.png

  • Delete all webhooks with the "Shiphero" prefix.

8_443d01a5-10b4-462a-bc68-5d91bba4aa51.png

  • Go back to the fulfillment site.
  • Disconnect.
Was this article helpful?
3 out of 13 found this helpful

More Resources

  • ShipHero Public API

    Connect your tools and AI agents directly to ShipHero with the Public API. Build powerful integrations, automate workflows, and tap into real-time data using the AI tools you prefer, with the option for secure, read-only access for AI-driven insights without added risk.

  • ShipHero Academy

    Explore ShipHero Academy for certifications, deep-dive training, and expert-led courses on WMS and fulfillment. Build your expertise and help your team operate at a higher level.

  • Change Log

    Stay up to date with the latest improvements across ShipHero. The Change Log gives you a clear view of new features, enhancements, and fixes as they roll out—so you always know what’s new and what’s better.