Create page

Create a static website with a CDN URL.

← All Pages endpoints · Capability overview

POST/v1/pages

https://api.vee3.io/v1/pages

200 tokens

Create a static website with a CDN URL.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

pages.create

Parameters2 fields

slugstringRequired

Page slug used for the public hostname ({slug}.vee3.site). Must be unique across Vee3. Lowercase alphanumeric characters and hyphens only; 1-48 characters; must start and end with an alphanumeric character.

max length 48

namestringOptional

Optional display name for the page. Does not change the public URL. At most 80 characters.

max length 80

Response8 fields

page_idstring

Unique identifier for the page.

namestring

Display name for the page, if set.

slugstring

Page slug.

statusstring

Current page status.

urlstring

Public HTTPS URL for the page (https://{slug}.vee3.site until a custom domain is attached).

hostnamestring

Preview hostname ({slug}.vee3.site). Always present, including when a custom domain is attached.

custom_domainstring

Custom hostname attached to the page, if any.

created_atstring

When the page was created.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, pages_not_configured, pages_upstream_error, page_slug_taken

Example request

Python

import requests

url = "https://api.vee3.io/v1/pages"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "slug": "docs",
    "name": "Docs"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Newly created page.

page_created.json

{
  "page_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Docs",
  "slug": "docs",
  "status": "active",
  "url": "https://docs.vee3.site",
  "hostname": "docs.vee3.site",
  "custom_domain": null,
  "created_at": "2026-08-11T12:00:00.000Z"
}