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

# Create a new auth server client

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

## Request

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

Create a new client for a given auth server. The client ID and secret will be generated automatically. The `name` attribute must be unique within the auth server. The `grant_types` and `response_types` attributes define the OAuth 2.0 and OpenID Connect capabilities of the client.

## Path parameters

- `authServerId` string, uuid, required

## Request body

- object
  - `name` string, required: The name of the client
  - `grant_types` GrantType[], required: List of OAuth 2.0 grant types
  - `response_types` ResponseType[], required: List of OAuth 2.0 response types
  - `redirect_uris` string[]: The URIs that the client is allowed to redirect to after authentication in interactive flows. All redirect URIs must be absolute URIs, be secure (HTTPS), and must not include a fragment component.
  - `login_uri` string, uri, nullable: **Pre-release Feature** This feature is currently in beta and is subject to change. The URI of the login page where the user is redirected to authenticate in interactive flows. The login page must be secure (HTTPS).
  - `access_token_duration` integer: The duration of the minted token is valid for, in seconds
  - `id_token_duration` integer: The duration of the minted token is valid for, in seconds
  - `allow_all_scopes` boolean: Specifies whether the client is allowed to request all scopes
  - `allow_scopes` string[]: Specifies the scopes IDs that the client is allowed to request
  - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
  - `token_endpoint_auth_method` 'private_key_jwt' | 'client_secret_post' | 'none': Requested authentication method for OAuth 2.0 endpoints.

## Response `201`

A client with a secret

- CreatedClient
  - `id` string, required: The OAuth 2.0 client ID
  - `name` string, required: The name of the client
  - `grant_types` GrantType[], required: List of OAuth 2.0 grant types
  - `redirect_uris` string[], required: The URIs that the client is allowed to redirect to after authentication in interactive flows. All redirect URIs must be absolute URIs, be secure (HTTPS), and must not include a fragment component.
  - `login_uri` string, uri, nullable: **Pre-release Feature** This feature is currently in beta and is subject to change. The URI of the login page where the user is redirected to authenticate in interactive flows. The login page must be secure (HTTPS).
  - `access_token_duration` integer, required: The duration of the minted token is valid for, in seconds
  - `id_token_duration` integer, required: The duration of the minted token is valid for, in seconds
  - `allow_all_scopes` boolean, required: Specifies whether the client is allowed to request all scopes
  - `allow_scopes` string[], required: Specifies the scopes IDs that the client is allowed to request
  - `labels` Labels, required: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
  - `response_types` ResponseType[], required: List of OAuth 2.0 response types
  - `token_endpoint_auth_method` 'private_key_jwt' | 'client_secret_post' | 'none': Requested authentication method for OAuth 2.0 endpoints.
  - `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.
  - `client_secret` string, required: The OAuth 2.0 client secret

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `409`: Conflict

## 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/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)
