Docly Child

Connection Troubleshooting

TrackShip for the WooCommerce plugin requires access to your WooCommerce store API to establish a connection. This connection allows TrackShip to retrieve and update the shipping information for your orders. To grant the necessary permissions, you’ll need to use the auth permission dialog. This guide will help you understand what might be causing the connection error and how to resolve it quickly and easily.


The “Deactivated” error message indicates that the TrackShip for WooCommerce plugin or a shipment tr has been deactivated on your store. To resolve this issue, simply activate the plugin by going to the plugin section in your WordPress dashboard and click on the activate button. Once you activate the plugin, go to TrackShip > Settings and re-start the connection process.


The “Unauthorized” error message can occur if the API key for TrackShip has been altered or if permissions have been revoked. This means that TrackShip no longer has the necessary permissions to access your WooCommerce store API. To resolve this issue, follow these steps:

  1. Go to the TrackShip dashboard and remove the connection to your store.
  2. Re-establish the connection to your store using the auth permission dialog.
  3. Check if the new API keys generated have the necessary read/write permissions.


The Forbidden error message in TrackShip for WooCommerce can occur when the WooCommerce REST API returns a Forbidden error. This can happen due to a security plugin blocking TrackShip’s write requests or a server/hosting configuration blocking HTTP requests from external websites. To resolve this issue, please follow the steps below:

  • Check security plugins: Check the settings of any security plugins installed on your site to see if they are blocking TrackShip’s write requests. If so, you may need to disable the security plugin or whitelist TrackShip in the plugin settings.
  • Server/hosting configuration: If a security plugin is not the cause of the Forbidden error, then it is possible that your server/hosting configuration is blocking HTTP requests from external websites. In this case, you will need to contact your hosting company and request that they remove the block.


The “Unknown” error message can occur if the SSL certificate is not installed correctly or the server is taking too long to respond. To resolve this issue, follow these steps:

  1. Check your SSL certificate and make sure it is installed correctly.
  2. If the certificate is installed correctly, reach out to your hosting company for further assistance.

We hope this guide has helped you understand the different connection errors that may occur with TrackShip for WooCommerce and how to resolve them. If you are still encountering issues, please don’t hesitate to reach out to our support team for further assistance.


A timeout error occurs when a connection to an eCommerce store takes more than 5 seconds to establish, or when the store does not respond within 5 seconds. Here are a few steps you can take to resolve the issue.

  1. Contact your hosting company: If you are experiencing timeout errors when using the WooCommerce API, the first step is to contact your hosting company’s support team. They can help identify the root cause of the issue and provide a solution.
  2. Ask about server resources: Ask your hosting company about the server resources allocated to your website. If your website is using shared hosting, you may be competing with other websites for resources. Upgrading to a dedicated server or a VPS may help alleviate the issue.
  3. Check server logs: Ask your hosting company to check the server logs for any errors or issues related to API requests. This can help identify any bottlenecks or server-side issues causing the timeouts.
  4. Optimize website performance: Work with your hosting company to optimize your website performance. This can include caching, optimizing images, and minimizing the use of resource-intensive plugins or themes.

Please Note: Connection timeout is a server issue that is beyond our control, and your hosting company is the best resource for resolving the issue. You can generate API Key from your admin and test your store’s WooCommerce API using Postman.

Download Now