Add Website Page
Add a page at path with the given HTML.
An existing page at the path is 409 website_page_exists (use PUT
…/pages/content to rewrite it). The new page is part of the DRAFT —
it goes live on the next POST …/publish.
Authorizations
API key from Settings > Developer > REST API
Headers
Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.
2026-04-12, 2026-05-01 "2026-05-01"
Path Parameters
Body
Page route path, e.g. '/' or '/pricing' (normalized: leading slash, no trailing slash; no whitespace).
1 - 500^\S+$The new page's HTML.
1 - 5000000Display name for the page (derived from the path when omitted, e.g. '/pricing' → 'Pricing').
255Optimistic-concurrency pin: when set, the operation is rejected with 409 website_version_conflict unless the site's current version matches. Read the version from any prior response on this surface.
x >= 1A retried call with the same key replays the stored response (replayed:true) instead of failing on the already-created page.
200Response
Successful Response
The response is of type Response Websitesaddpage · object.