Create Page

Creates a new page in a site.

POST /v6/pages

Create Page

cURL

curl --request POST \
  --url https://api.makeswift.com/v6/pages \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "siteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pathname": "<string>",
  "name": "<string>"
}
'

201

{
  "object": "page",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pathname": "furniture",
  "canonicalUrl": "<string>",
  "title": "<string>",
  "description": "<string>",
  "socialImageUrl": "<string>",
  "sitemapPriority": 0.5,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "publishedAt": "2023-11-07T05:31:56Z",
  "isOnline": true,
  "excludedFromSearchEngines": true,
  "localizations": [
    {
      "pathname": "<string>",
      "locale": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "locale": "<string>"
}

Authorizations

x-api-key · string · header · required

API key authentication. Accepts either:

• App API key (e.g. sk_eczMHVBY9fV6GYFhvs53qcnxq7yptlXL3ABKOZtn6dQ)
• Site API key (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)

Body

application/json

siteId · string<uuid> · required

The site ID to create the page for.

pathname · string · required

The page pathname.

name · string · required

The page name.

Minimum string length: 1

Response

201

application/json

object · enum<string> · required

Available options: page

Example:

"page"

id · string<uuid> · required

The ID of the page.

pathname · string · required

The page pathname.

Example:

"furniture"

canonicalUrl · string | null · required

The canonical URL of the page.

title · string | null · required

The page title.

description · string | null · required

The page description.

socialImageUrl · string | null · required

The social image URL of the page.

sitemapPriority · number | null · required

The sitemap priority.

Required range: 0 <= x <= 1

sitemapFrequency · enum<string> | null · required

The sitemap update frequency.

Available options: always, hourly, daily, weekly, monthly, yearly, never

createdAt · string<date-time> | null · required

The page creation date and time.

updatedAt · string<date-time> | null · required

The page last update date and time.

publishedAt · string<date-time> | null · required

The page publication date and time.

isOnline · boolean · required

The flag that indicates whether the page is online.

excludedFromSearchEngines · boolean | null · required

The flag that indicates whether the page is excluded from search.

localizations · object[] · required

The localizations of the page.

Show child attributes

locale · string

The page locale. This defaults to the default locale of the parent site.