---
title: "Create Secret"
method: POST
path: "/api/v2/pipelines/{name}/secrets"
tags: ["v2", "pipelines", "secrets"]
---

# Create Secret

`POST /api/v2/pipelines/{name}/secrets`

Creates a new pipeline secret.

## Path parameters

- `name` string, required — Pipeline name

## Request body

- PipelineSecretCreateRequest — Request model for creating a new pipeline secret.
  - `key` string, required
  - `value` string, required
  - `type` 'simple' | 'file' | 'binary_file'

## Response `201`

Successful Response

- PipelineSecretResponse — Response model for a pipeline secret.
  - `key` string, required
  - `type` 'simple' | 'file' | 'binary_file', required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict

## Changes

- **2026-07-16** `e381b64b5ffc` — 1 warning, 1 info
  - added the new `binary_file` enum value to the `type` response property for the response status `201`
  - added the new `binary_file` enum value to the request property `type`
- **2026-04-29** `d5de67e6bd60` — 1 info
  - endpoint added
- **2025-02-27** `b0ed6c7dac42` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/redis/apis/redis-data-integration-api/changes/api/v2/pipelines/:name/secrets/post.md)

---

[API](https://skmtc.dev/redis/apis/redis-data-integration-api.md) · [All operations](https://skmtc.dev/redis/apis/redis-data-integration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redis/redis-data-integration-api/revisions/30f630f0aac5/schema)