Skip to main content
POST
Create Page

Create Page

Creates a new page in the store.

Request

Body Parameters

Only the fields listed below are persisted. Any other keys in the body are ignored.
string
required
The page title
string
URL-safe handle. Provide one — if omitted, the handle is stored as null (there is no auto-slugify from the title).
string
Page content (HTML)
string
Custom template suffix (e.g., contact for page.contact.liquid)
Optional external link for the page
boolean
default:"true"
Whether to display the page title on the storefront
string
Custom page title for search engines
string
Meta description for search engines
string
Open Graph / social share image URL

Response

integer
HTTP status code (201 on success)
string
Outcome state, success on success
string
Human-readable message, null on success
object
Wrapper containing the created page object

Example Response

Error Response

When title is missing or blank, the request returns a 400 envelope:

Error Codes