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.
title
string
required
The page title
handle
string
URL-safe handle. Auto-generated from the title if not provided.
content
string
Page content (HTML)
templateSuffix
string
Custom template suffix (e.g., contact for page.contact.liquid)
Optional external link for the page
showtitle
boolean
default:"true"
Whether to display the page title on the storefront
seoTitle
string
Custom page title for search engines
seoDesc
string
Meta description for search engines
seoImage
string
Open Graph / social share image URL

Response

status
integer
HTTP status code (201 on success)
state
string
Outcome state, success on success
message
string
Human-readable message, null on success
data
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

StatusStateDescription
401errorInvalid or missing access token
403errorApp doesn’t have write_content scope
400errorMissing required field (e.g. title)