---
title: "Create"
method: POST
path: "/vault_secrets"
tags: ["Secrets"]
---

# Create

`POST /vault_secrets`

Create a new Secret

## Headers

- `ngrok-version` integer, required

## Request body

- SecretCreate
  - `name` string — Name of secret
  - `value` string — Value of secret
  - `metadata` string — Arbitrary user-defined metadata for this Secret
  - `description` string — description of Secret
  - `vault_id` string — unique identifier of the referenced vault
  - `vault_name` string — name of the referenced vault

## Response `201`

Create a new Secret

- Secret
  - `id` string — identifier for Secret
  - `uri` string — URI of this Secret API resource
  - `created_at` string — Timestamp when the Secret was created (RFC 3339 format)
  - `updated_at` string — Timestamp when the Secret was last updated (RFC 3339 format)
  - `name` string — Name of secret
  - `description` string — description of Secret
  - `metadata` string — Arbitrary user-defined metadata for this Secret
  - `created_by` Ref
    - `id` string — a resource identifier
    - `uri` string — a uri for locating a resource
  - `last_updated_by` Ref
    - `id` string — a resource identifier
    - `uri` string — a uri for locating a resource
  - `vault` Ref
    - `id` string — a resource identifier
    - `uri` string — a uri for locating a resource
  - `vault_name` string — Name of the vault the secret is stored in

---

[API](https://skmtc.net/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.net/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/versions/1994bbb04714/schema)