---
title: "Register a new client"
method: POST
path: "/api/v1beta1/clients"
tags: ["clients"]
---

# Register a new client

`POST /api/v1beta1/clients`

## Request body

- Client
  - `client_id` string, required
  - `client_secret` string — Required for clients with kind 'confidential'
  - `kind` 'public' | 'confidential', required
  - `allowed_scopes` string, required
  - `allowed_redirect_uris` string[], required

## Response `200`

New client details

- Client
  - `client_id` string, required
  - `client_secret` string — Required for clients with kind 'confidential'
  - `kind` 'public' | 'confidential', required
  - `allowed_scopes` string, required
  - `allowed_redirect_uris` string[], required

## Other responses

- `401` — Authentication failed
- `409` — A client with the given client ID already exists

## Changes

> 2 revisions in range; 1 could not be searched.

- **2020-06-09** `fef8c7872fcf` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/enseadaio/apis/enseada/changes/api/v1beta1/clients/post.md)

---

[API](https://skmtc.dev/enseadaio/apis/enseada.md) · [All operations](https://skmtc.dev/enseadaio/apis/enseada/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enseadaio/enseada/revisions/e8c51f6a5e52/schema)