---
title: "Create a new client secret"
method: POST
path: "/v1/auth-servers/{authServerId}/clients/{clientId}/secrets"
tags: ["Auth Server Clients"]
---

# Create a new client secret

`POST /v1/auth-servers/{authServerId}/clients/{clientId}/secrets`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v1/auth-servers/{authServerId}/clients/{clientId}/secrets`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Create a new client secret for a given client. Multiple secrets can be active simultaneously for a single client.

## Path parameters

- `authServerId` string, uuid, required
- `clientId` string, required: The OAuth 2.0 client ID

## Request body

- CreateSecretPayload
  - `secret` string: The OAuth 2.0 client secret
  - `enabled` boolean: Specifies whether the secret is enabled. If the secret is not enabled, it will not be usable during authentication phase.

## Response `201`

A Client Secret item

- ClientSecretItem: The client secret. The secret value is only returned when creating a new secret item.
  - `id` string, uuid, required: The ID of the client secret
  - `enabled` boolean, required: Specifies whether the secret is enabled. If the secret is not enabled, it will not be usable during authentication phase.
  - `secret` string: The OAuth 2.0 client secret
  - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity update date.

## Other responses

- `400`: Bad Request
- `403`: Forbidden

## Changes

- **2026-11-02** `7e077577b247`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/auth-servers/:authServerId/clients/:clientId/secrets/post.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) - [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/3b071797f6e4?raw)
