---
title: "Create RUM replay session watch"
method: POST
path: "/api/v2/rum/replay/sessions/{session_id}/watches"
tags: ["Rum Replay Viewership"]
---

# Create RUM replay session watch

`POST /api/v2/rum/replay/sessions/{session_id}/watches`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/rum/replay/sessions/{session_id}/watches`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`

Record a session watch.

## Path parameters

- `session_id` string, required

## Request body

- Watch: A single RUM replay session watch resource returned by create operations.
  - `data` WatchData, required: Data object representing a session watch record, including its identifier, type, and attributes.
    - `attributes` WatchDataAttributes: Attributes for recording a session watch event, including the application, event reference, and timestamp.
      - `application_id` string, required: Unique identifier of the RUM application containing the session.
      - `data_source` string: Data source type indicating the origin of the session data (e.g., rum or product_analytics).
      - `event_id` string, required: Unique identifier of the RUM event that was watched.
      - `timestamp` string, date-time, required: Timestamp when the session was watched.
    - `id` string: Unique identifier of the watch record.
    - `type` 'rum_replay_watch', required: Rum replay watch resource type.

## Response `201`

Created

- Watch: A single RUM replay session watch resource returned by create operations.
  - `data` WatchData, required: Data object representing a session watch record, including its identifier, type, and attributes.
    - `attributes` WatchDataAttributes: Attributes for recording a session watch event, including the application, event reference, and timestamp.
      - `application_id` string, required: Unique identifier of the RUM application containing the session.
      - `data_source` string: Data source type indicating the origin of the session data (e.g., rum or product_analytics).
      - `event_id` string, required: Unique identifier of the RUM event that was watched.
      - `timestamp` string, date-time, required: Timestamp when the session was watched.
    - `id` string: Unique identifier of the watch record.
    - `type` 'rum_replay_watch', required: Rum replay watch resource type.

## Other responses

- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)