---
title: "Create a playback token key"
method: POST
path: "/playback_tokens/keys"
tags: ["advanced_token_authentication"]
---

# Create a playback token key

`POST /playback_tokens/keys`

This operation creates a playback token key that includes a key id and key value. You use one or both of these parameters to create a playback token for advanced token authentication. 

Before using the **ADVANCED_TOKEN** option as your token authentication for a video, you must do **one** of the following: 

  - Generate a playback token key that has a key id using this endpoint in the Wowza Video API, then customize and generate a token via the Wowza Video 2.0 API to add to your site. You'll need the key id to create and sign the token.  
  - Generate a playback token key that has a key id and key value using this endpoint in the Wowza Video 2.0 API, then customize and generate a standard common access token (CAT) through the means you usually use to create tokens to add to your site. You'll need the key id and key to create and sign the token. 
    The key value is only returned in this endpoint so keep it in a place that you can access it later when you create your playback token.

## Request body

- CreatePlaybackTokenKeyRequestWrapper — Create Playback Token Key request for the Wowza Video REST API.
  - `playback_token_key` CreatePlaybackTokenKeyRequestModel
    - `name` string, required — The name of the playback token key for the organization.

## Response `200`

Success

- CreatePlaybackTokenKeyResponseWrapper — Playback token key response from the Wowza Video REST API.
  - `playback_token_key` CreatePlaybackTokenKeyResponseModel
    - `id` string — The unique identifier for the key for the organization. The id will contain the organization id in the key id. If you generate a playback token for advanced token authentication by either using the Wowza Video API or by generating a standard common access token (CAT) through the means you usually use to create tokens, you'll need to add this key id during token creation to sign the token.
    - `organization_id` string — The organization id for Wowza Video.
    - `name` string — The name of the key for the organization.
    - `created_at` string, date-time — The key creation timestamp.
    - `value` string — The key value for the key. If you generate a playback token for advanced token authentication by creating a standard common access token (CAT) through the means you usually use to create tokens, you'll need to add this key value during token creation to sign the token. The key value is only returned in this endpoint so keep it in a place that you can access it later when you create your playback token.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `410` — Gone
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation.md) · [All operations](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wowza/wowza-video-rest-api-reference-documentation/revisions/157b6f741f2a/schema)