## **🛠️ Common failure modes and fixes**

### **🔑 Auth error — connector marked as invalid**

**Cause:** Your Wix OAuth token has expired, or your Wix API Key is missing a required permission. A common case is the API Key lacking the **Manage Blog** permission, which surfaces as: `Categories endpoint failed: Invalid or expired API Key. Please ensure your Wix API Key has the 'Manage Blog' permission enabled.`

**Fix:** Delete the connector in Account Menu → Settings → CMS Connectors and reconnect with a fresh OAuth authorization. Make sure you authorize all requested permissions, including **Manage Blog**. The connector now tracks and exposes its credential status, so an invalid or disconnected connector is flagged in the UI before publishing; use the reconnect flow to restore it.

### 🔍 Meta-site not found — sync fails resolving the Wix site

**Cause:** The credential can't be matched to a valid Wix site (meta-site), shown as `Categories endpoint failed: meta-site not found`.

**Fix:** Reconnect the connector and authorize the correct Wix site so the credential is bound to a resolvable meta-site.

### **👤 Missing member — publish fails with member\_id required**

**Cause:** No author/member was selected in the connector settings.

**Fix:** Edit the connector and select a valid Wix member as the default author. The member must exist in your Wix site's member list.

### ⏳ Rate limit — publish hangs

**Cause:** Wix API rate limit hit during batch publishing.

**Fix:** Handled automatically with retry logic. Wait a few minutes; the publish will complete on its own.

## ✅ Post-publish verification error codes

- `CONTENT_MISSING` — article didn't appear; try republishing
- `PAGE_NOT_ACCESSIBLE` — page is live but returns an error when accessed
- `CONTENT_MISMATCH` — content on page doesn't match what was sent

Contact support with the error code and article URL if the issue persists after republishing.