Sites
create_site
Create a new draft site for the caller's account and return the generated subdomain slug plus its canonical public_url. If you have not read the Sentway authoring guide in this session, call get_authoring_guide before authoring pages or configuring access. The new site has no pages, so its first save_page should write the homepage at path '/' ('/index' is an ordinary page and does NOT serve at the site root). Use when the model needs a new site container before authoring pages. Do not use to rename or replace an existing site.
Behaviour
- Effect
- Write. It creates or updates data in the account.
- Repeat calls
- Idempotent. Repeating the same call produces the same result.
- Plan
- Available on every plan, including free.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| request_id | string | Yes | Unique mutation ID; reuse only to replay identical arguments, new ID after E_CONFLICT. |
| name | string | Yes | Display name for the new site; Sentway generates the slug. |
Returns
| Name | Type | Description |
|---|---|---|
| site | object | - |
| idempotency_replay | boolean | - |
| homepage_missing | boolean | TRUE when the site's current authoring version has no page at '/'. A site with no '/' page 404s at its root URL. '/index' does not count. |
| public_url | string | Canonical visitor URL for this site, derived from the server-generated slug. A brand-new site will NOT serve content at this URL until it has a homepage at '/' and has been published with publish_site. |
| recommended_next_tool | string | Non-binding guidance, not a required workflow step: the tool most useful next. For a brand-new site this is 'get_authoring_guide' — read it once per session before authoring pages or configuring access. |
Using it
create_site is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 56 Sentway tools. See connecting over MCP.