Create landing page preview
create_landing_page_previewUse this tool when you have the final HTML of a new page: a landing page (ランディングページ), a page of the user's ホームページ or Webサイト, or one of many guide, FAQ, or comparison pages made for search and AI answers. It creates the whole page preview in a single Convika call, and is the default tool for a new page.
This tool creates the page, puts it at the requested path or URL when provided, sets conversion goals, saves the HTML content as the first version, and creates a token-protected preview URL. It avoids multi-step approval prompts in MCP clients.
Where a page goes: a workspace holds sites, and each of its pages is a path on one of them: .convika.page, or the workspace's own domain once its pages open there (get_brand shows them). Pass path, such as /guides/how-to-choose, to put the page there. Leave path out and the first page sits at /, a later one at a free path made from its name. subdomain is only for the workspace's first page: it names the workspace's convika.page site. For a full URL on a domain, such as https://www.example.com/lp2, pass url instead of path.
If guidance.existingSite is present, the requested URL shows or forwards to another site now, and connecting it would replace that. Tell the user before any DNS change, as the text says.
New pages per UTC day, per workspace: Free 10, Pro 100, MAX 1000. The count resets at midnight UTC and includes pages created through the dashboard, uploads, built-in AI, MCP, and free tools. Deleting a page does not restore the day's allowance.
Forms: create_form needs the siteId this tool returns, so a form can't be embedded in this first call. Leave the form out (or keep a placeholder section), then call create_form with the returned siteId, save the HTML with the form embed via save_page_content, and call create_preview so the preview shows the working form.
Do not use publish_site unless the user explicitly asks to publish/go live in production.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| js | No | JavaScript for interactive elements. | |
| css | No | Custom CSS for styles Tailwind cannot express. | |
| url | No | Optional exact custom URL requested by the user, for example 'https://www.example.com/lp2' or 'www.example.com/lp2'. A root URL such as 'https://example.com/lp2' goes on 'https://www.example.com/lp2', and example.com redirects to www once its DNS points at Convika (guidance.rootRedirect has the records). If the reply has guidance.rootNotServed instead, example.com without www won't open the page. | |
| html | Yes | Complete HTML document using Tailwind CSS v3. Must include the Tailwind CDN script in <head>. The page (html, css, and js together) can be up to 2 MB. | |
| name | Yes | Display name for the page | |
| path | No | The page's path on the workspace's site, such as '/guides/how-to-choose' or '/menu': lowercase letters, numbers, and hyphens between slashes. For a page after the first, write one: 1 to 3 English words that say what the page is, even when the page is in Japanese (料金表 → /pricing). Left out, Convika makes a free path from the name (the first page sits at /). Not together with url. | |
| goals | No | Optional conversion goals to configure before preview creation. | |
| locale | No | Language for the page content. | en |
| purpose | No | Landing page purpose. | |
| industry | No | Landing page industry. | |
| patterns | No | Pattern metadata. Accepted for backward compatibility; prefer sections. | |
| sections | No | Sections in the page, matching <section> order in the HTML. Prefer providing real descriptions; if omitted, Convika synthesizes placeholder section metadata from the HTML. | |
| changelog | No | Description of this initial version. | |
| subdomain | No | Only for the workspace's first page, while get_brand has no hostLabel: it names the workspace's site, <subdomain>.convika.page, and this page sits at /. Lowercase letters, numbers, and hyphens. Later pages share that site: give them path instead. Never put a requested path such as /lp2 here. | |
| primaryOffer | No | The main offer or CTA promise, such as a free trial, demo, consultation, or purchase. Saved on the page; get_site returns it. | |
| productSummary | No | What the page promotes, in one or two sentences. Saved on the page; get_site returns it. | |
| targetAudience | No | Who the page is for, in one sentence (e.g. 'office workers near Shibuya station'). Saved on the page; get_site returns it. | |
| designOverrides | No | Optional bounded design knob overrides. | |
| designProfileId | No | Optional design profile ID. | |
| designRationale | No | Short design rationale. | |
| expectedBrandId | No | The workspace's id from get_brand. When the connection now works on another workspace (the dashboard's active workspace was switched), the call changes nothing and answers brand_mismatch. |