---
title: "POST /ImportPlaybackKeyPair"
method: POST
path: "/ImportPlaybackKeyPair"
---

# POST /ImportPlaybackKeyPair

`POST /ImportPlaybackKeyPair`

Imports the public portion of a new key pair and returns its <code>arn</code> and <code>fingerprint</code>. The <code>privateKey</code> can then be used to generate viewer authorization tokens, to grant viewers access to private channels. For more information, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html">Setting Up Private Channels</a> in the <i>Amazon IVS User Guide</i>.

## Request body

- object
  - `name` string — Playback-key-pair name. The value does not need to be unique.
  - `publicKeyMaterial` string, required — The public portion of a customer-generated key pair.
  - `tags` object — Any tags provided with the request are added to the playback key pair tags. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is documented there.

## Response `200`

Success

- ImportPlaybackKeyPairResponse
  - `keyPair` object — <p/>
    - `arn` string — Key-pair ARN.
    - `fingerprint` string — Key-pair identifier.
    - `name` string — Playback-key-pair name. The value does not need to be unique.
    - `tags` object — Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is documented there.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — PendingVerification
- `483` — ConflictException
- `484` — ServiceQuotaExceededException

---

[API](https://skmtc.net/aws/apis/ivs.md) · [All operations](https://skmtc.net/aws/apis/ivs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/ivs/versions/32a77504a115/schema)