---
title: "Add a Page"
method: POST
path: "/playlists/{id}/pages"
---

# Add a Page

`POST /playlists/{id}/pages`

add page to a playlist

## Path parameters

- `id` string, required

## Headers

- `content-type` string

## Request body

- object
  - `description` string — field acts as a name of a page
  - `duration` integer — specify certain amount of time for page to play
  - `transition` string — transition for playlist applies here
  - `default_page` boolean
  - `ignored_tags` string[] — do not display on device that has tag
  - `require_tags` string[] — display on devices that have tag
  - `days` string[] — add days scheduling option to a page
  - `hours_from` string — add display hours option to a playlist, format "00:00:00"
  - `hours_to` string — format "00:00:00"
  - `start` integer — start date and time ,format "start":1581112800
  - `end` integer — end date and time format "end":1581112800
  - `auto_remove` boolean — if true, page will be removed when time specified in "end" parameter comes
  - `campaign_id` string — put adcapmaign ID here
  - `background` string — "bgType=custom&bgMedia=urlOfIImageHere&darkOverlay=false&zoomEffect=false&whiteText=true"
  - `grid_template` string — By default page has one zone, with this parameter you can define custom grid for a page
  - `hours` string — combine hours_from and hours_to into one string "00:00:00-01:02:00"

## Response `200`

200

- object
  - `created_at` number
  - `description` string
  - `grid_template` string
  - `id` string
  - `playlist_id` string
  - `priority` integer
  - `updated_at` number

## Other responses

- `400` — 400

---

[API](https://skmtc.net/telemetrytv/apis/user-api.md) · [All operations](https://skmtc.net/telemetrytv/apis/user-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/telemetrytv/user-api/versions/057a0b968aea/schema)