Create Web Page

Return the current Create Web Page account context. Use this to check whether the user is authenticated or using an anonymous expiring demo.

RECOMMENDED first step for building a page. Returns the few questions worth asking (business name, primary visitor action, key content, optional source link) so you can then call page.create_from_brief. This is the simplest, most reliable path — prefer it. (page.onboarding.* offers extra category/layout/palette pickers but is a stateless planning helper, not required.) Call once per creation request; skip if the user already gave you a source URL. Does not create a page.

• originalRequeststringThe user's original page-creation request, copied verbatim when available.
• businessNamestringOnly include if the user already provided the business or project name.
• businessTypestringBusiness category inferred from the user's words, such as hamburger restaurant or dental clinic.
• sourceUrlstringPublic HTTP/HTTPS source URL provided by the user, such as a business website or link-in-bio page. Protected platforms (social networks, maps, paywalls) require client-side browsing or pasted details instead.
• sourceHandlestringPublic social handle provided by the user.
• primaryGoalstringThe main visitor action if known, such as book, call, WhatsApp, buy, or leave a lead.
• localestringPreferred content locale if obvious from the conversation.

Optional planning helper that returns category/layout/palette/primary-action choices and a quality checklist (it does NOT create a page). Use it only if you want those pickers; otherwise page.intake.start → page.create_from_brief is the simpler path. IMPORTANT: this flow is STATELESS — page.onboarding.update does not remember earlier calls, so each update must resend the FULL set of selections + knownFields gathered so far. As soon as you have a business name and a primary action, stop and call page.create_from_brief (you do not need to reach a 'ready' step).

• originalRequeststring
• localestringPreferred UI locale, such as es or en.
• suggestedSelectionobject

Validate onboarding selections and return the remaining checklist. STATELESS: it does not remember previous calls, so every call must include the FULL accumulated selection (mainCategory, subCategory, layout, palette, primaryAction) plus all knownFields (name, description, action destination, etc.) gathered so far — not just the latest answer, or earlier choices will look 'missing'. You do not need to loop to a 'ready' state: once you have a name and a primary action, call page.create_from_brief with those values.

• stepIdstring
• localestring
• selectionobject
• knownFieldsobject

Fetch a public website URL and extract a structured brief with business name, description, contact links, and suggested page blocks. Only works with public HTTP/HTTPS pages. Does not bypass login, CAPTCHA, or paywalls. Returns extracted fields and suggestedBlocks for use with page.create_from_brief.

• sourceUrlstringrequiredPublic http/https source URL to import.
• localestringPreferred output locale if obvious from the conversation, such as es or en.

Create a hosted link-in-bio page draft from a style preset. Provide title, displayName, and a preset (or 'auto' to infer from businessType/style). The page starts with empty placeholder blocks for you to fill in via block.update — do not invent content. This tool intentionally creates a draft only and does not return a publish action. After calling it, stop and show the preview URL. Do not call page.publish in the same turn unless the user's current message explicitly asks to publish, make the page live, or get a public share link. Anonymous demo pages expire unless claimed.

• titlestringrequiredInternal page title and default header display_name.
• displayNamestringVisible header display name. Defaults to title.
• biostringOptional short bio for the header.
• businessTypestringUsed by preset:auto inference. Examples: musician, restaurant, designer.
• slugstringPreferred public URL slug.
• layoutstringLayout id. Defaults to 'link_in_bio'.
• presetstringrequiredStyle preset id, or 'auto' to infer deterministically from businessType/style.
• stylestringFree-form style hint used by preset:auto inference.
• initialPromptstring

Create a hosted landing page draft from a structured brief. Accepts business name, category, layout, palette, primary action, explicit final-audience publicSections, and optional hero image. Planning fields such as audience, offer, primaryGoal, location, businessType, style, and mustInclude are context only and are not rendered as public body copy. Draft previews are customer-facing: do not pass owner instructions, section-planning labels, or placeholder copy as public content. Keep sparse briefs sparse: use only facts supplied by the user or imported public sources, plus light wording polish; do not invent menus, services, hours, facilities, locations, testimonials, guarantees, staff details, prices, or operational claims. Prefer one short section or no extra section when the prompt is minimal. If a requested CTA lacks its real destination, ask for it before creation or provide fallbackLeadForm with public copy. Returns a preview URL, edit token, and next-step hints. This tool intenti

• businessNamestringrequired
• biostringOptional short bio for the header.
• businessTypestringPlanning context only. Not rendered directly as public page copy.
• preferredSlugstringDesired URL path. Ask the user for it near the end of onboarding. Use normal letters, numbers, and hyphens; the server normalizes and makes it unique.
• layoutstringDefaults to 'link_in_bio'.
• presetstringStyle preset id, or 'auto' to infer deterministically. Defaults to 'auto'.
• sourceUrlstringProvenance reference only.
• sourceHandlestring
• primaryGoalstringPlanning context only. Not rendered directly as public page copy.
• audiencestringPlanning context only. Not rendered directly as public page copy.
• offerstringPlanning context only. Not rendered directly as public page copy; use bio and publicSections for final-audience copy.
• locationstringPublic business address or service area intended for map/address actions, not direct body copy and not the user's private/current location.
• publicWhatsappstringPublic WhatsApp phone number explicitly supplied by the user or a public source. Do not use the user's account phone or invent placeholder numbers.
• publicPhonestringPublic business phone number explicitly supplied by the user or a public source. Do not use the user's private/account phone.
• publicBusinessEmailstringPublic business contact email explicitly supplied by the user or a public source. Do not use the user's ChatGPT/account email.
• stylestringPlanning context only. Not rendered directly as public page copy.
• mustIncludearrayPlanning checklist only. Do not put section names, CTA labels, owner instructions, or private notes here; not rendered directly.
• publicSectionsarrayFinal-audience text sections to render on the public page. Write in the target language with correct spelling/accents. Only include facts the user supplied or that came from an imported public source; for sparse prompts, keep this short and avoid invented service lists, hours, benefits, testimonials, prices, or operational details.
• initialPromptstring
• localestring
• onboardingMainCategorystringValidated atom.bio category id from page.onboarding.*, for example physical-business or online-business.
• onboardingSubCategorystringValidated atom.bio subcategory id, for example health.
• onboardingLayoutstringLayout style: background_color (minimalist), full (featured photo), or background_image (full image background).
• onboardingPalettestringPalette id returned by page.onboarding.* paletteChoices, for example atom_dark_plum.
• primaryActionIdstring
• primaryActionLabelstringPublic label for the primary action in the page's target language.
• fallbackLeadFormobjectPublic fallback contact/interest form to use when the requested primary action lacks a real destination. All copy must be final-audience copy in the page's target language.
• primaryActionUrlstringReal destination URL for the primary action when explicitly supplied by the user or imported public source, such as a booking link. Do not invent booking/order URLs; if missing, ask for it or use fallbackLeadForm.
• heroImageUrlstringExplicit user-provided image URL for featured-photo or full-image styles.

Append a new content block to a link-in-bio page. The block must match one of the 13 allowed types (link, social_row, whatsapp, phone_call, email_contact, image, gallery, video_embed, text, map_embed, product_card, lead_form, reviews) with that type's strict props. The server generates the block id and returns it in the response. For already-published pages, this saves an unpublished latest revision only. Do not call page.publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page.publish. Do NOT call page.unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down. The response includes nextSteps: after adding a block, share these hints with the user so they know what else would make the page more complete.

• pageIdstringrequired
• editTokenstring
• blockobjectrequiredThe block to add. Must match one of the 13 allowed types with that type's strict props schema. The server generates the block id.

List supported page layouts. v1 ships link_in_bio only.

List the 8 curated style presets (theme + starter blocks) for link-in-bio. Use to offer the user a choice or to confirm a preset:auto selection.

Read a landing page draft, including its latest content JSON. For anonymous demo pages, include the editToken.

• pageIdstringrequired
• editTokenstring

Claim an anonymous demo page into an AUTHENTICATED account. This requires the signed-in user's OAuth — an anonymous chat/agent session cannot call it and will get an OAuth-required error. So in a normal agent conversation, do NOT call this to 'save' a demo page: instead share the claimUrl from the page.create/page.publish result with the user, who opens it, signs in, and keeps the page. Only call page.claim when the request already runs under the owner's OAuth.

• pageIdstringrequiredThe pageId returned by page.create.
• editTokenstringrequiredThe editToken returned by page.create for the anonymous demo page.

List landing pages claimed by the authenticated account. This requires OAuth and is for account management, not first-time demo creation.

• limitnumberMaximum number of claimed pages to return.

Read a claimed account page without requiring an editToken. Use after OAuth when the user wants to manage a durable website.

• pageIdstringrequiredThe claimed pageId to manage.

Update the link-in-bio page header: displayName, bio, verified checkmark, and QR display. Use only the fields you want to change. For already-published pages, this saves an unpublished latest revision only. Do not call page.publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page.publish. Do NOT call page.unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.

• pageIdstringrequired
• editTokenstring
• displayNamestringVisible display name in the page header.
• bioShort bio under the display name. Pass null to clear it.
• verifiedbooleanShow a verified checkmark next to the display name.
• showQrbooleanShow a QR code for this page.

Apply a partial theme patch. Theme fields are enum-constrained (button variant/radius/shadow, font family/weight, density, icon_size). Use presets.list first if the user wants a complete restyle. For already-published pages, this saves an unpublished latest revision only. Do not call page.publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page.publish. Do NOT call page.unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.

• pageIdstringrequired
• editTokenstring
• themeobjectrequiredPartial theme patch. Provide only fields you want to change.

Update internal page title, URL slug, and SEO title/description. For already-published pages, this saves an unpublished latest revision only. Do not call page.publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page.publish. Do NOT call page.unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.

• pageIdstringrequired
• editTokenstring
• titlestringInternal page title shown in editor results.
• slugstringPreferred public URL slug.
• seoTitlestringSEO <title> tag value.
• seoDescriptionstringSEO meta description value.

Return the current preview URL for a page.

• pageIdstringrequiredThe pageId returned by page.create.
• editTokenstringRequired for anonymous demo pages. Use the editToken returned by page.create.

Publish the latest page revision. Call this only when the user's latest message explicitly asks to publish, make the page live, or get a public share link. Do not call this immediately after page.create or page.create_from_brief just because the draft is publish-ready. For anonymous demo pages, include the editToken returned by page.create. The response includes nextSteps: always share these with the user after publishing — they include the claim reminder and any remaining improvements.

• pageIdstringrequiredThe pageId returned by page.create.
• editTokenstringRequired for anonymous demo pages. Use the editToken returned by page.create.

Remove a published landing page from public availability while keeping its draft and revision history.

• pageIdstringrequired
• editTokenstring

Patch one content block by stable blockId. Provide a props patch (merged into existing props) and/or a new type. Block types and props are validated against the strict per-type schema. For already-published pages, this saves an unpublished latest revision only. Do not call page.publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page.publish. Do NOT call page.unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.

Delete one block by stable blockId. Use page.get first if unsure which id to remove. For already-published pages, this saves an unpublished latest revision only. Do not call page.publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page.publish. Do NOT call page.unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.

• pageIdstringrequired
• editTokenstring
• blockIdstringrequired

Move a block to a new zero-based index in the page main slot. For already-published pages, this saves an unpublished latest revision only. Do not call page.publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page.publish. Do NOT call page.unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.

• pageIdstringrequired
• editTokenstring
• blockIdstringrequired
• toIndexnumberrequired