For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Creates a *Page*. The request payload limit is 1MB.
**Required Fields**
* `type`
* `name`
* `link` (for a page of `type: link`)
* `body` (for a page of `type: raw`)
**Read Only Fields**
* `id`
## Content Type
The default value for `content_type` is `text/html`; however, if `page_type` is set to `raw`, `content_type` can be changed to `text/javascript` or `application/json`. Updating this field lets you place a JavaScript or a JSON file in the root directory.
> #### Warning
> **Deprecated**
> * This API operation is deprecated. Avoid using this API operation if possible. It will be removed in a future version.
> * To create one or more pages, use Pages V3ʼs [Create pages](/developer/api-reference/rest/admin/content/pages/create-pages) endpoint.
Creates a Page. The request payload limit is 1MB.
Required Fields
type
name
link (for a page of type: link)
body (for a page of type: raw)
Read Only Fields
id
Content Type
The default value for content_type is text/html; however, if page_type is set to raw, content_type can be changed to text/javascript or application/json. Updating this field lets you place a JavaScript or a JSON file in the root directory.
Warning
Deprecated
This API operation is deprecated. Avoid using this API operation if possible. It will be removed in a future version.
To create one or more pages, use Pages V3ʼs Create pages endpoint.
Authentication
X-Auth-Tokenstring
### OAuth scopes
| UI Name | Permission | Parameter |
|:--------|:-----------|:----------|
| Content | modify | `store_v2_content` |
| Content | read-only | `store_v2_content_read_only` |
### Authentication header
| Header | Argument | Description |
|:-------|:---------|:------------|
| `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts). |
### Further reading
For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests).
For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes).
For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).
Path parameters
store_hashstringRequired
Permanent ID of the BigCommerce store.
Headers
AcceptstringRequiredDefaults to application/json
The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of the response body.
Request
This endpoint expects an object.
namestringRequired
Page name, as displayed on the storefront.
bodystringRequired
HTML or variable that populates this page’s <body> element, in default/desktop view. Required in POST if page type is raw.
typeenumRequired
page: free-text page
link: link to another web address
contact_form: When the store’s contact form is used
Allowed values:
channel_iddoubleOptional
channel ID
meta_titlestringOptional
Text specified for this page’s <title> element. If empty, the value of the name property is used.
is_visiblebooleanOptional
If true, this page appears in the storefront’s navigation menu.
parent_idintegerOptional
ID of any parent Web page.
sort_orderintegerOptional
Order in which this page should display on the storefront. (Lower integers specify earlier display.)
meta_keywordsstringOptional
Comma-separated list of SEO-relevant keywords to include in the page’s <meta/> element.
meta_descriptionstringOptional
Description contained within this page’s <meta/> element.
is_homepagebooleanOptional
If true, this page is the storefront’s home page.
is_customers_onlybooleanOptional
If true, this page is for customers only.
search_keywordsstringOptional
Comma-separated list of keywords that shoppers can use to locate this page when searching the store.
has_mobile_versionbooleanOptional
If true, this page has a mobile version. (For Blueprint themes only)
mobile_bodystringOptional
HTML to use for this page’s body when viewed in the mobile template (deprecated - Blueprint themes only).
contact_fieldsstringOptional
Where the page’s type is a contact form: object whose members are the fields enabled (in the control panel) for storefront display. Possible members are:fullname: full name of the customer submitting the form; phone: customer’s phone number, as submitted on the form; companyname: customer’s submitted company name; orderno: customer’s submitted order number; rma: customer’s submitted RMA (Return Merchandise Authorization) number.
emailstringOptional
Where the page’s type is a contact form, the email address that receives messages sent using the form.
urlstringOptional
Relative URL on the storefront for this page.
layout_filestringOptional
Layout template for this page. This field is writable only for stores with a Blueprint theme applied.
linkstringOptional
If page type is link this field is returned. Required in POST to create a link page.
content_typeenumOptional
Allowed values:
Response
bodystring
HTML or variable that populates this page’s <body> element, in default/desktop view. Required in POST if page type is raw.
channel_iddouble
Channel ID.
contact_fieldsstring
Where the page’s type is a contact form - object whose members are the fields enabled (in the control panel) for storefront display. Possible members are:fullname - full name of the customer submitting the form; phone - customer’s phone number, as submitted on the form; companyname- customer’s submitted company name; orderno- customer’s submitted order number; rma - customer’s submitted RMA (Return Merchandise Authorization) number.
content_typeenum
Allowed values:
emailstring
Where the page’s type is a contact form, the email address that receives messages sent using the form.
has_mobile_versionboolean
If true, this page has a mobile version. (For Blueprint themes only)
idintegerRead-only
ID of the page. Read-Only.
is_customers_onlyboolean
If true, this page is for customers only.
is_homepageboolean
If true, this page is the storefront’s home page.
is_visibleboolean
If true, this page appears in the storefront navigation menu.
layout_filestring
Layout template for this page. This field is writable only for stores with a Blueprint theme applied.
linkstring
If page type is link, this field is returned.
meta_descriptionstring
Description contained within this page’s <meta/> element. HTML to use for this page’s body when viewed in the mobile template.
meta_keywordsstring
Comma-separated list of SEO-relevant keywords to include in the page’s <meta/> element.
meta_titlestring
Text specified for this page’s <title> element. If empty, the value of the name property is used.
mobile_bodystring
HTML to use for this page’s body when viewed in the mobile template (deprecated - Blueprint only).
namestring
Page name, as displayed on the storefront.
parent_idinteger
ID of any parent Web page.
search_keywordsstring
Comma-separated list of keywords that shoppers can use to locate this page when searching the store.
sort_orderinteger
Order in which this page should display on the storefront. (Lower integers specify earlier display.)
typeenum
page: free-text page
link: link to another web address
contact_form: When the store’s contact form is used
Allowed values:
urlstring
Relative URL on the storefront for this page.
OAuth scopes
UI Name
Permission
Parameter
Content
modify
store_v2_content
Content
read-only
store_v2_content_read_only
Authentication header
Header
Argument
Description
X-Auth-Token
access_token
For more about API accounts that generate access_tokens, see our Guide to API Accounts.
