Skip to main content
POST
/
v6
/
pages
Create Page
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>"
}
'
{
  "object": "page",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pathname": "furniture",
  "canonicalUrl": "<unknown>",
  "title": "<unknown>",
  "description": "<unknown>",
  "socialImageUrl": "<unknown>",
  "sitemapPriority": "<unknown>",
  "sitemapFrequency": "always",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "publishedAt": "<unknown>",
  "isOnline": true,
  "excludedFromSearchEngines": "<unknown>",
  "localizations": [
    {
      "pathname": "<string>",
      "locale": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "locale": "<string>"
}

Authorizations

x-api-key
string
header
required

The App API key.

(e.g. sk_eczMHVBY9fV6GYFhvs53qcnxq7yptlXL3ABKOZtn6dQ)

Body

application/json
siteId
string<uuid>
required

The site ID to create the page for.

pathname
string
required

The page pathname.

Minimum string length: 1
name
string
required

The page name.

Minimum string length: 1

Response

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
null
required

The canonical URL of the page.

title
null
required

The page title.

description
null
required

The page description.

socialImageUrl
null
required

The social image URL of the page.

sitemapPriority
null
required

The sitemap priority.

sitemapFrequency
null
required

The sitemap update frequency.

Available options:
always,
hourly,
daily,
weekly,
monthly,
yearly,
never
createdAt
null
required

The page creation date and time.

updatedAt
null
required

The page last update date and time.

publishedAt
null
required

The page publication date and time.

isOnline
boolean
required

The flag that indicates whether the page is online.

excludedFromSearchEngines
null
required

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

localizations
object[]
required

The localizations of the page.

locale
string

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