---
title: "Create a media timings set"
method: POST
path: "/v2/sites/{site_id}/media/{media_id}/timings/"
tags: ["ssai"]
---

# Create a media timings set

`POST /v2/sites/{site_id}/media/{media_id}/timings/`

## Request

- Base URL: `https://api.jwplayer.com`
- URL: `https://api.jwplayer.com/v2/sites/{site_id}/media/{media_id}/timings/`
- Auth: API key in header `Authorization`

Create a set of ad timings for a media

## Path parameters

- `site_id` string, required: Unique identifier for a resource
- `media_id` string, required: Unique identifier for a resource

## Request body

- TimingMetadata
  - `metadata` object, required
    - `ad_timings` object
      - `timings` object[]: List of ad timecodes
        - `timecode` string: Start time of the ad as a timecode

## Response `201`

Request to create timing successful

- TimingResourceRead
  - `schema` string
  - `id` string: Unique identifier for a resource
  - `created` string: Date and time at which the resource was created
  - `last_modified` string: Date and time at which the resource was most recently modified
  - `type` string: Name of the type of resource.
  - `relationships` object: Ancilliary resources associated to the primary resource being read
  - `metadata` object, required
    - `ad_timings` object
      - `timings` object[]: List of ad timecodes
        - `timecode` string: Start time of the ad as a timecode

## Changes

- **2026-11-03** `9fad6bd5872e`: 1 warning, 1 info
  - changed the pattern of the request property `metadata/ad_timings/timings/items/timecode` from `^(?!00:00:00:000)[0-2][0-3]:[0-5][0-9]:[0-5][0-9].[0-9]{3}$` to `^(?!00:00:00\.000)([01]\d|2[0-3]):([0-5]\d):([0-5]\d)\.(\d{3})$`
  - the `allOf[#/components/schemas/TimingMetadata]/metadata/ad_timings/timings/items/timecode` response's property pattern was changed from `^(?!00:00:00:000)[0-2][0-3]:[0-5][0-9]:[0-5][0-9].[0-9]{3}$` to `^(?!00:00:00\.000)([01]\d|2[0-3]):([0-5]\d):([0-5]\d)\.(\d{3})$` for the status `201`

[Operation history](https://skmtc.dev/jwplayer/apis/management-api-v2/changes/v2/sites/:site_id/media/:media_id/timings/post.md)

---

[API](https://skmtc.dev/jwplayer/apis/management-api-v2.md) - [All operations](https://skmtc.dev/jwplayer/apis/management-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jwplayer/apis/management-api-v2/revisions/9fad6bd5872e?raw)