---
title: "Create a new page"
method: POST
path: "/v1/workspace/website/{website_id}/pages/create"
tags: ["Page Management"]
---

# Create a new page

`POST /v1/workspace/website/{website_id}/pages/create`

## Request

- Base URL: `https://api.lindo.ai`
- URL: `https://api.lindo.ai/v1/workspace/website/{website_id}/pages/create`
- Auth: HTTP bearer

Creates a new page and publishes it with full HTML content. Parses HTML to extract title, SEO metadata, and custom codes.

## Path parameters

- `website_id` string, required: Unique identifier of the website

## Request body

- PageCreateRequest
  - `html` string: Full HTML content of the page
  - `page_content` string: Deprecated alias for `html`. Kept for backward compatibility with older MCP clients (<= @lindoai/mcp-server 1.1.0). Prefer `html`; if both are provided, `html` wins.
  - `path` string, required: URL path for the page
  - `settings` object: Page settings
  - `template_name` string: Page title/name
  - `custom_codes` object: Custom code to inject in header and footer
    - `header` string
    - `footer` string
  - `seo` object: SEO metadata for the page

## Response `200`

Page created and published successfully

- PageCreateResponse
  - `success` true, required: Indicates the operation was successful
  - `result` PageCreateResult, required
    - `message` string, required: Success message
    - `page_id` string, required: Unique identifier of the created page
    - `publish_date` number, required: Unix timestamp when the page was published
    - `published_url` string, required: Full URL where the page is published

## Other responses

- `400`: Bad request - validation error
- `401`: Unauthorized - invalid or missing API key
- `404`: Website not found
- `500`: Internal server error

---

[API](https://skmtc.dev/lindo/apis/lindo-unified-api.md) · [All operations](https://skmtc.dev/lindo/apis/lindo-unified-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lindo/apis/lindo-unified-api/revisions/2672f34525a4?raw)