# Insert of page

Creates a new page.

Endpoint: POST /api/pages
Version: 1.0.0
Security: shoptetAccessToken, shoptetPrivateApiToken

## Header parameters:

  - `Content-Type` (string, required)

## Request fields (application/json):

  - `data` (object, required)

  - `data.title` (string, required)
    page title

  - `data.indexName` (string)
    ending part of page URL

  - `data.description` (string,null)
    page content

  - `data.linkText` (string,null)
    page title in the menu

  - `data.metaTitle` (string,null)
    page meta title

  - `data.metaDescription` (string,null)
    page meta description

  - `data.canonicalUrl` (string,null)
    canonical URL of the page

  - `data.visible` (boolean)
    flag whether the page is visible on web

  - `data.access` (any)
    flag indicating, whether the page can be viewed by everyone (value of the flag is: all), by logged in users only ('logged-in'), by logged out users only ('logged-out'), or by administrators only ('admin-only')
    Enum: "all", "logged-in", "logged-out", "admin-only"

  - `data.sourceOgImageName` (string,null)
    Name of file in [Files upload](#section/basic-principles/files-upload) storage to be set as article open-graph image. When set to null, image will be removed.

## Response 201 fields (application/json):

  - `data` (object, required)

  - `data.page` (object, required)

  - `data.page.id` (integer, required)
    page ID

  - `data.page.language` (string)
    Page language. Available only if module foreignLanguages is active and initialized.

  - `data.page.title` (string, required)
    page title

  - `data.page.content` (string,null, required)
    page content

  - `data.page.url` (string, required)
    page URL

  - `data.page.linkText` (string,null, required)
    text of the page link

  - `data.page.metaTitle` (string,null, required)
    page meta title

  - `data.page.metaDescription` (string,null, required)
    page meta description

  - `data.page.canonicalUrl` (string,null, required)
    Canonical URL of the page

  - `data.page.visible` (boolean, required)
    flag whether the page is visible on web

  - `data.page.access` (any, required)
    flag indicating, whether the page can be viewed by everyone (value of the flag is: 'all'), by logged in users only ('logged-in'), or by logged out users only ('logged-out'), or by administrators only ('admin-only')
    Enum: "all", "logged-in", "logged-out", "admin-only"

  - `data.page.ogImage` (string,null, required)
    page og:image

  - `errors` (array,null, required)

  - `errors.errorCode` (string, required)
    Short text error identification

  - `errors.message` (string, required)
    Descriptive error message

  - `errors.instance` (string, required)
    Identification of the entity referenced

  - `metadata` (object, required)

  - `metadata.requestId` (string, required)
    Request identifier. Useful for logging/reporting purposes.

## Response 422 fields (application/json):

  - `data` (object,null)

  - `errors` (array,null)

  - `metadata` (object)