🔑 Fix Wix CMS API Key Authentication Errors

Camilo Aponte

Camilo Aponte

Last updated on Sep 30, 2026

🔍 Overview

When connecting Wix CMS to Search Atlas, you may encounter an authentication error that reads: "Invalid or expired API Key. Please ensure your Wix API Key has the 'Manage Blog' permission enabled." This article walks you through the most common causes and how to fix them.

⚠️ Common Causes of This Error

  • The API key is missing the required Manage Blog permission
  • The API key was regenerated or expired after the initial connection was made
  • The Account ID was not included during setup
  • The wrong Wix site is associated with the API key
  • The API key belongs to a different Wix account than the one managing the site

🛠️ Step-by-Step Troubleshooting

  1. Log in to your Wix account and go to Settings > API Keys in the Wix dashboard.
  2. Verify the Manage Blog permission is enabled on your API key. If it is not checked, edit the key, enable the permission, and save.
  3. Locate your Account ID. In Wix, your Account ID appears in the API Keys section, typically labeled Account ID at the top of the page. This is different from your Site ID.
  4. Re-enter your credentials in Search Atlas. Go to the Wix CMS connector settings via Account Menu → Settings → CMS Connectors in Search Atlas, remove the existing connection, and reconnect using both your API Key and your Account ID.
  5. Confirm the correct site is selected. During reconnection, make sure the site you are linking matches the site associated with your API key.
  6. Generate a new API key if needed. If the key may have been regenerated or revoked, create a fresh API key in Wix, ensure Manage Blog is enabled, and use the new key in Search Atlas.

✅ Required Wix API Key Permissions

Your Wix API key must have at least the following permission enabled for the Search Atlas integration to work correctly:

  • Manage Blog — required to read categories, posts, and other blog data

Without this permission, Search Atlas cannot authenticate against the Wix API, even if the key itself is valid.

🔄 Reconnecting After Fixing Your Credentials

Once you have corrected your API key permissions or generated a new key, follow these steps to restore the connection:

  1. Open Search Atlas and navigate to your CMS Connector settings.
  2. Select your Wix connection and click Disconnect or Reconnect.
  3. Enter your updated API Key and Account ID in the fields provided.
  4. Click Connect and wait for the status indicator to confirm a successful connection.
  5. If the connection succeeds, trigger a manual sync to confirm data is flowing correctly.

❓ Frequently Asked Questions

Do I need to include my Account ID? Yes. The Account ID is a required field. Submitting only the API key without the Account ID will cause the connection to fail, even if all permissions are correctly set.

My permissions look correct but I still get the error. What should I do? Try generating a brand-new API key in Wix and reconnecting. Existing keys can become invalid if your Wix account credentials or plan change.

What does "meta-site not found" mean? This error typically means the API key is associated with a different Wix account or site than the one you are trying to connect. Double-check that the Account ID and API key both belong to the same Wix account that owns the target site.

💬 Still Need Help?

If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.