Troubleshooting your WooCommerce integration

Estimated 5 minute read

|

Updated Mar 30, 2026, 12:00 AM EST

Table of contents

You will learn

Learn how to solve issues with your WooCommerce integration setup by following the relevant troubleshooting scenario described below. If you are encountering issues not on this list, please reach out on the Community or to our Support Team.

Before you begin

If you have not already, read our guide on getting started with WooCommerce for step-by-step instructions on integrating. If you are looking to upgrade your plugin, check out our article on how to upgrade your WooCommerce plugin.

Troubleshooting scenarios

Consult the following scenarios based on the error message received in-app to resolve your issue.

Removing and re-integrating WooCommerce does not delete profiles or previously synced events from Klaviyo. However, removing the integration stops syncing and removes WooCommerce coupon definitions from Klaviyo.

“To avoid functionality disruptions, you may need to disable the following plugins: Plugin Name(s)”

If you have active caching plugins or redirect plugins in WordPress, these can interfere with Klaviyo’s integration and cause connection issues. We recommend disabling these plugins during the integration setup process.

Troubleshooting your WooCommerce integration - 图1

Troubleshooting your WooCommerce integration - 图2

“We can’t complete your setup”

Troubleshooting your WooCommerce integration - 图3

Troubleshooting your WooCommerce integration - 图4

This heading can appear for different setup errors. Read the message under Details and use the matching troubleshooting section below.

If the details mention a firewall or security layer, allowlist Klaviyo integration traffic and disable Bot Fight Mode in Cloudflare if it is enabled.

  1. Learn how to allowlist Klaviyo integration traffic IP addresses.
  2. If you use Cloudflare, follow its instructions to disable Bot Fight Mode.

After updating your firewall settings, try connecting the WooCommerce integration again.

“Ensure your WooCommerce store has https and SSL enabled”

Troubleshooting your WooCommerce integration - 图5

Troubleshooting your WooCommerce integration - 图6

Klaviyo expects your store URL to adhere to HTTPS protocols, meaning that the website has a valid SSL certificate. If your website is in HTTP rather than HTTPS, you may run into issues.

You can check if your SSL certificate is valid at SSL Server Test (Powered by Qualys SSL Labs).

Resolve any SSL certificate errors, then try connecting your store again.

“Unable to access API with provided credentials”

You may receive this error if you have customizations in place to prevent API access for non-logged-in users. Typically, this is a function in the functions.php WordPress file, which triggers a 401 status code response.

If you have a customization like this, delete it or comment it out to eliminate the error. For more information on this error, check out the WordPress REST API FAQ.

“Unable to access the orders API, please check connection settings and try again”

This error can appear when Klaviyo cannot validate access to your store’s order data. For example, the Klaviyo plugin’s order-count endpoint may return a missing or invalid count, or a request to your store may fail.

Check that the Klaviyo plugin is installed, active, and up to date, and that your store allows Klaviyo’s API requests. Resolve any errors before retrying the connection.

To inspect the order-count response with the latest Klaviyo plugin installed, run the following cURL request. Replace STORE_URL with your store’s domain, and replace CONSUMER_KEY and CONSUMER_SECRET with your WooCommerce REST API credentials.

textCopy

curl --include "https://STORE_URL/wp-json/klaviyo/v1/orders/count" \
  -H "X-Klaviyo-Consumer-Key: CONSUMER_KEY" \
  -H "X-Klaviyo-Consumer-Secret: CONSUMER_SECRET"

A successful response includes an order_count value, such as {“order_count”: 0} for a store with no orders. If you receive an error, share the status and error message with your developer or Klaviyo Support. Do not share your consumer secret.

Updating your Klaviyo plugin

Troubleshooting your WooCommerce integration - 图7

Troubleshooting your WooCommerce integration - 图8

Follow How to upgrade the WooCommerce plugin to check for and install an available update. You do not need to remove the integration to update the plugin. If you have just updated it, a delayed settings webhook can temporarily leave Klaviyo showing the previous settings. Allow a few minutes, then refresh the integration page.

404 when connecting to Klaviyo from WordPress

To resolve this, you should confirm that you have Permalinks enabled for your WordPress site. WooCommerce authentication will not work unless Permalinks are enabled.

  1. Navigate to your WordPress site and go to Settings > Permalinks.
  2. Under Common Settings, choose any link structure other than Plain.
  3. Confirm by clicking Save Changes.

Troubleshooting your WooCommerce integration - 图9

Troubleshooting your WooCommerce integration - 图10

  1. When you’re done, re-integrate with Klaviyo.

Installation Failed - We were unable to install your extension

You may encounter an “Installation Failed” error when attempting to install the integration via the WooCommerce Marketplace.

image (1).png

image (1).png

If installation from the WooCommerce Marketplace fails, install and activate the Klaviyo plugin from your WordPress admin. See WordPress’s plugin installation guide for current instructions.

  1. Navigate to your WordPress admin and go to Plugins.
  2. Select Add New.
  3. Search for Klaviyoin Search Plugins.
  4. Select Install Now.
  5. Select Activate.
  6. Select Marketing from the lefthand navigation, then click Klaviyo.
  7. Click Connect Account to begin, then proceed to Enable the WooCommerce integration in the Getting started with WooCommerce article.

Webhook events aren't reaching Klaviyo

If WooCommerce events fail to reach Klaviyo, check the following connection and permission issues. If the problem continues, contact Klaviyo Support.

1. Your firewall or security plugin blocks the DELETE request

Klaviyo sends DELETE requests to remove existing webhooks when re-registering them. If your firewall or security plugin blocks these requests, old webhooks can remain in place. Check for blocked DELETE requests when troubleshooting webhook setup.

How to check:

  1. Open your firewall or security plugin.
  2. Check the request log for blocked DELETE requests to a /wp-json/ URL.
  3. If your host manages the firewall, ask your host to check its logs instead.

How to fix: Allow the DELETE method on /wp-json/wc/v3/webhooks/ in your firewall or security plugin rules. If your host manages the firewall, ask the host to make this change.

2. Cloudflare or another WAF blocks the request before WordPress sees it

If your site sits behind Cloudflare or another web application firewall (WAF), the WAF can block or challenge Klaviyo's API calls before they reach WordPress. Check your firewall logs to confirm a block. A 403 permission error such as the following does not, by itself, prove that the firewall caused the problem:

{“code”:“woocommerce_rest_cannot_view”,“message”:“Sorry, you cannot list resources.”,“data”:{“status”:403}}

How to check:

  1. Open your Cloudflare dashboard, or your WAF's dashboard.
  2. Go to the security event log.
  3. Look for blocked or challenged requests to a /wp-json/wc/v3/ URL, around the time of the failure.

How to fix: Add an IP Access Rule in Cloudflare (or the equivalent in your WAF) that allows Klaviyo's integration IP ranges, with the action set to Allow. See How to allowlist Klaviyo integration traffic IP addresses for the full IP range list and step-by-step Cloudflare instructions.

3. Your API key does not have write access

Klaviyo uses a WooCommerce REST API key to read store data and manage webhooks. If this key has Read permission only, WooCommerce blocks write actions, including webhook registration. The request can fail with a permission error.

How to check: Follow the steps below, or see WooCommerce’s REST API key guide for current key-management instructions.

  1. In WordPress, go to WooCommerce > Settings > Advanced > REST API.
  2. Find the key used for your Klaviyo integration.
  3. Check the value in the Permissions column.

How to fix:

  1. Click Edit on the key.
  2. Change Permissions to Read/Write.
  3. Save the key.

Do not revoke the key and create a new one. A new key has a new secret. The new secret breaks Klaviyo's connection to your store.

After correcting the connection or permissions, retry setup if it failed. If the integration is connected but events still do not arrive, contact Klaviyo Support with the error details.

Additional resources

Learn how to install the Klaviyo WooCommerce extension and enable the WooCommerce integration in your Klaviyo account.

This article covers the data that is synced when you integrate your WooCommerce store with your Klaviyo account.

Was this article helpful?

YesNo

Use this form only for article feedback. Learn how to contact support.

Explore more from Klaviyo

Community

Connect with peers, partners, and Klaviyo experts to find inspiration, share insights, and get answers to all of your questions.

Visit Community

Partners

Hire a Klaviyo-certified expert to help you with a specific task, or for ongoing marketing management.

Hire a partner

Support

Access support through your account.

Email support (free trial and paid accounts) Available 24/7

Chat/virtual assistance Availability varies by location and plan type

Log in