---
title: "POST /clients"
method: POST
path: "/clients"
tags: ["client"]
---

# POST /clients

`POST /clients`

クライアントを登録します。

## Request body

- object
  - `name` string, required — クライアント名(1-32文字)
  - `description` string, required — クライアントの説明
  - `redirectUri` string, uri, required — リダイレクト先のURI
  - `scopes` string[], required — 要求するスコープ(必ず１つ以上)

## Response `200`

正常に登録できました。クライアント情報を返します。

- OwnedClientInfo
  - `clientId` string — クライアントID
  - `name` string — クライアント名
  - `description` string — クライアント説明
  - `creatorId` string, uuid — クライアント作成者UUID
  - `scopes` string[] — 要求スコープの配列
  - `redirectUri` string, uri — OAuth2リダイレクトURL
  - `secret` string — クライアントSecret

## Other responses

- `400` — 登録できませんでした。リクエスト内容が不正です。
- `403` — 登録できませんでした。権限がありません。

## Changes

- **2019-07-05** `6956f2622a20` — 8 info
  - api operation id `createClient` removed and replaced with ``
  - the endpoint scheme security `traqOAuth2` was added to the API
  - endpoint reactivated
  - added optional request body
  - …4 more

[Change history](https://skmtc.dev/traptitech/apis/traq-api/changes/clients/post.md)

---

[API](https://skmtc.dev/traptitech/apis/traq-api.md) · [All operations](https://skmtc.dev/traptitech/apis/traq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traptitech/traq-api/revisions/6956f2622a20/schema)