KwikScaleAI

Publishing

Wix

Available

Publish AI-generated articles to a Wix Blog using API key auth. The adapter handles Wix's proprietary Ricos content format automatically, auto-creates tags that don't exist, and resolves existing categories by name.

Prerequisites

  • A Wix site with the Wix Blog app installed. Most Wix business plans include it — add it from Wix App Market if missing.
  • Site owner or admin access to generate an API key.

Setup guide

  1. Go to manage.wix.com → select your site → Settings.
  2. In the left nav, find Headless Settings → API Keys.
  3. Click Generate API Key. Name it KwikScaleAI.
  4. Grant the key Wix Blog permissions: both Manage Blog and Read Blog.
  5. Copy the API key (shown only once) and the site ID.
  6. In KwikScaleAI: Integrations → Wix → Connect. Paste API key + site ID.
  7. Click Test connection.

How it works

Publishing is a multi-step flow because of Wix's Ricos format:

  1. HTML → Ricos: POST /ricos/v1/ricos-document/convert/to-ricosto convert the article HTML into Wix's JSON content tree.
  2. Tag resolution: for each tag, GET /blog/v3/tags/by-label/{label}. If 404, POST /blog/v3/tags to create it.
  3. Category resolution: POST /blog/v3/categories/queryto look up existing categories by label (categories aren't auto-created).
  4. Draft creation: POST /blog/v3/draft-posts with the Ricos document, tag IDs, category IDs, and metadata.
  5. Publish (if publishStatus: published): POST /blog/v3/draft-posts/{id}/publish.

Updates use PATCH /blog/v3/draft-posts/{id} followed by a re-publish call.

Auth headers
Authorization: {apiKey}
wix-site-id: {siteId}
Content-Type: application/json

Configuration

apiKeyRequired

string

Wix API key generated in Headless Settings → API Keys. Must have Wix Blog Read + Write scopes.

siteIdRequired

string (UUID)

Wix site UUID. Found in the API Keys page alongside the key.

accountIdOptional

string

Optional Wix member ID for post authorship. If empty, the site owner is auto-assigned.

publishStatusOptional

'published' | 'draft'

published creates the draft and immediately publishes it. draft creates the draft without publishing — you finish the flow manually in Wix Blog admin.

Default: published

Capabilities

Update existing
Draft
Tags
Categories
Featured image
Scheduled publish
Delete

Troubleshooting

401 Unauthorized
API key is wrong or lacks Wix Blog scopes. Regenerate the key with both Manage Blog and Read Blog permissions.
Ricos conversion fails
Wix's Ricos converter rejects certain HTML (iframes, script tags, embedded video, some custom CSS). KwikScaleAI sanitizes output to safe HTML before sending, but if you see Ricos errors, check if your article template emits anything unusual. Stripping to plain markdown → basic HTML usually fixes it.
Categories don't attach
Categories must exist in Wix Blog before publish — the adapter only resolves, it does not create categories (tags are auto-created). Create the category first in Wix Blog admin with the exact name you're configuring.
403 with site ID mismatch
The API key was generated for a different site than the siteId you configured, or the wix-site-id header isn't accepted by the key's scopes. Regenerate the key on the correct site.
Post created but invisible on the storefront
Either publishStatus is 'draft' (switch to 'published'), or Wix Blog isn't added to your site's main menu. Go to Wix Editor → Pages → Blog and ensure the blog page is set to show your published posts.

FAQ

Why does Wix need HTML→Ricos conversion?
Wix stores blog content in their proprietary Ricos format (a JSON content tree, not HTML). KwikScaleAI generates articles as HTML, so the adapter first calls Wix's /ricos/v1/ricos-document/convert/to-ricos endpoint to convert HTML → Ricos, then creates the post. This adds one extra round trip per publish — usually imperceptible.
How do I get a Wix API key?
Go to manage.wix.com → your site → Settings → Headless Settings → API Keys → Generate API Key. Grant the key the Wix Blog scopes: Read + Write. Copy the key (shown once) and paste it into KwikScaleAI.
Where do I find my Wix site ID?
In the API Keys page (same place as above), or from any Wix Dev Center URL — it's the UUID right after /dashboard/. You can also find it in the browser URL while editing your site.
Can I publish to a specific Wix Blog author/member?
Optionally. Set the accountId config field to a member ID. Leave empty and Wix auto-assigns the site owner as author.
Does the integration support Wix Stores product content?
No — v1 is scoped to Wix Blog posts only. For product descriptions, use the Custom Webhook and wire the Wix Stores API yourself.

Ready to automate publishing?

Connect your site once. KwikScaleAI researches, writes, and publishes SEO content on autopilot.

Get started free