---
title: "Create RUM replay playlist"
method: POST
path: "/api/v2/rum/replay/playlists"
tags: ["Rum Replay Playlists"]
---

# Create RUM replay playlist

`POST /api/v2/rum/replay/playlists`

Create a playlist.

## Request body

- Playlist — A single RUM replay playlist resource returned by create, update, or get operations.
  - `data` PlaylistData, required — Data object representing a RUM replay playlist, including its identifier, type, and attributes.
    - `attributes` PlaylistDataAttributes — Attributes of a RUM replay playlist, including its name, description, session count, and audit timestamps.
      - `created_at` string, date-time — Timestamp when the playlist was created.
      - `created_by` PlaylistDataAttributesCreatedBy — Information about the user who created the playlist.
        - `handle` string, required — Email handle of the user who created the playlist.
        - `icon` string — URL or identifier of the user's avatar icon.
        - `id` string, required — Unique identifier of the user who created the playlist.
        - `name` string — Display name of the user who created the playlist.
        - `uuid` string, required — UUID of the user who created the playlist.
      - `description` string — Optional human-readable description of the playlist's purpose or contents.
      - `name` string, required — Human-readable name of the playlist.
      - `session_count` integer — Number of replay sessions in the playlist.
      - `updated_at` string, date-time — Timestamp when the playlist was last updated.
    - `id` string — Unique identifier of the playlist.
    - `type` 'rum_replay_playlist', required — Rum replay playlist resource type.

## Response `201`

Created

- Playlist — A single RUM replay playlist resource returned by create, update, or get operations.
  - `data` PlaylistData, required — Data object representing a RUM replay playlist, including its identifier, type, and attributes.
    - `attributes` PlaylistDataAttributes — Attributes of a RUM replay playlist, including its name, description, session count, and audit timestamps.
      - `created_at` string, date-time — Timestamp when the playlist was created.
      - `created_by` PlaylistDataAttributesCreatedBy — Information about the user who created the playlist.
        - `handle` string, required — Email handle of the user who created the playlist.
        - `icon` string — URL or identifier of the user's avatar icon.
        - `id` string, required — Unique identifier of the user who created the playlist.
        - `name` string — Display name of the user who created the playlist.
        - `uuid` string, required — UUID of the user who created the playlist.
      - `description` string — Optional human-readable description of the playlist's purpose or contents.
      - `name` string, required — Human-readable name of the playlist.
      - `session_count` integer — Number of replay sessions in the playlist.
      - `updated_at` string, date-time — Timestamp when the playlist was last updated.
    - `id` string — Unique identifier of the playlist.
    - `type` 'rum_replay_playlist', required — Rum replay playlist resource type.

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)
