Create Headless Site

View the file in GitHub
Download skillThe skill is a reference md and part of wix-manage skill. You can use the following command to add the full wix-manage skill to your project:
Copy

Headless sites are not created from templates. One account-level call creates the site, installs the requested Wix Business Solution apps, and creates and configures the site's OAuth client.

Do NOT use the Create Site from Template API for headless sites — it only tags the site's namespace and skips the headless setup entirely.

Prerequisites

  • Wix account with site creation permissions
  • Account-level API access

Provision a Headless Business

Endpoint: POST https://www.wixapis.com/headless-business-setup/v1/headless-business/provision

Request Body:

Copy
  • namingStrategy — exactly one of: metaSiteName (exact display name), llmPromptBasedName: {} (name derived from the top-level prompt field), or defaultName: {}
  • seedOptions — Wix Business Solution apps to install at creation: STORES, BLOG, BOOKINGS, EVENTS, PORTFOLIO, PRICING_PLANS. Each entry takes clearTemplateContent (remove sample content) and seedDemoContent (seed demo content). Empty installs none
  • synchronousSteps — steps to complete before the call returns: SET_METASITE_NAME, CONFIGURE_HEADLESS_APP, SEED_CONTENT. Omitted steps run asynchronously. Include CONFIGURE_HEADLESS_APP when the OAuth client must be usable immediately

Response:

Copy

appId is the site's OAuth client ID — do NOT create a separate OAuth app.

Existing Sites

To provision headless onto an existing site, pass "existingMetasite": {} instead of newMetasite. This is a site-level call in the context of that site.

Next Steps

After creating the site:

  • Install additional apps using Install Wix Apps
  • Add content (products, services, blog posts, etc.)

Last updated: 28 July 2026

Did this help?