---
title: "Create playlist."
method: POST
path: "/playlists"
tags: ["playlists"]
---

# Create playlist.

`POST /playlists`

## Request body

- CreatePlaylistCommand
  - `interval` string
  - `items` PlaylistItem[]
    - `Id` integer
    - `PlaylistId` integer
    - `order` integer
    - `title` string
    - `type` string
    - `value` string
  - `name` string

## Response `200`

(empty)

- Playlist — Playlist model
  - `id` integer
  - `interval` string — Interval sets the time between switching views in a playlist. FIXME: Is this based on a standardized format or what options are available? Can datemath be used?
  - `name` string — Name of the playlist.
  - `uid` string — Unique playlist identifier. Generated on creation, either by the creator of the playlist of by the application.

## Other responses

- `401` — UnauthorizedError is returned when the request is not authenticated.
- `403` — ForbiddenError is returned if the user/token has insufficient permissions to access the requested resource.
- `404` — NotFoundError is returned when the requested resource was not found.
- `500` — InternalServerError is a general error indicating something went wrong internally.

---

[API](https://skmtc.net/nforgeio/apis/grafana-http-api.md) · [All operations](https://skmtc.net/nforgeio/apis/grafana-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nforgeio/grafana-http-api/revisions/3cb6c3f42dc7/schema)