---
title: pingcli pingone keys create
description: Create a new key
component: pingcli
version: 1.5
page_id: pingcli:command_reference:pingcli_pingone_keys_create
canonical_url: https://developer.pingidentity.com/pingcli/1.5/command_reference/pingcli_pingone_keys_create.html
llms_txt: https://developer.pingidentity.com/pingcli/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: August 10, 2026
section_ids:
  synopsis: Synopsis
  examples: Examples
  options: Options
  options-inherited-from-parent-commands: Options inherited from parent commands
  more-information: More information
---

# pingcli pingone keys create

Create a new key

## Synopsis

Create a new key pair in a PingOne environment

```
pingcli pingone keys create [flags]
```

## Examples

```
  # Create a new key pair from a JSON file
  pingcli pingone keys create --environment-id <env-id> --from-file key.json

  # Create a new key pair from stdin
  pingcli pingone keys create --environment-id <env-id> --from-file - < key.json

  # Create a new key pair from flags, without --from-file
  pingcli pingone keys create --environment-id <env-id> --algorithm RSA --key-length 2048 --name "My Key" --signature-algorithm SHA256withRSA --subject-dn "CN=example.com" --usage-type SIGNING --validity-period 365
```

## Options

```
  -e, --environment-id string        The PingOne environment ID
  -h, --help                         help for create
  -f, --from-file string             Path to a JSON file containing the request body, or "-" to read from stdin.
      --algorithm string             The key algorithm (e.g. RSA, EC)
      --custom-crl string            A custom Certificate Revocation List endpoint URL, used for certificates of type ISSUANCE
      --default                      Whether this is the default key for the environment
      --issuer-dn string             The distinguished name of the certificate issuer
      --key-length int64             The key length in bits (e.g. 2048, 4096 for RSA; 256, 384 for EC)
      --name string                  The display name for the key
      --signature-algorithm string   The signature algorithm (e.g. SHA256withRSA, SHA256withECDSA)
      --subject-dn string            The distinguished name for the generated certificate (e.g. CN=example.com)
      --usage-type string            The intended key usage (e.g. SIGNING, ENCRYPTION, SIGNING_AND_ENCRYPTION)
      --validity-period int64        The number of days the key is valid
```

## Options inherited from parent commands

```
  -C, --config string           The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml)
  -D, --detailed-exitcode       Enable detailed exit code output. (default false) 0 - pingcli command succeeded with no errors or warnings. 1 - pingcli command failed with errors. 2 - pingcli command succeeded with warnings.
  -O, --output-format string    Specify the console output format. (default text) Options are: json, ndjson, ndjson-typed, ndjson-wrapped, text.
  -P, --profile string          The name of a configuration profile to use.
      --debug                   Enable debug output for error messages, including stack traces and transaction IDs. (default false)
      --log-file string         Write logs to a file at the given path. File logging is disabled when not set.
      --log-file-level string   Set the file log level. Options are: DEBUG, INFO, WARN, ERROR. (default DEBUG)
      --log-level string        Set the console log level. Options are: DEBUG, INFO, WARN, ERROR. (default WARN)
      --no-color                Disable text output in color. (default false)
      --query string            JMESPath expression to filter JSON output. Requires -O json, ndjson, ndjson-typed, or ndjson-wrapped. Example: --query 'data[?enabled].name'
```

## More information

* [pingcli pingone keys](pingcli_pingone_keys.html) - Keys