---
title: "Register OAuth client"
method: POST
path: "/oauth/register"
tags: ["OAuth2"]
---

# Register OAuth client

`POST /oauth/register`

Register a dynamic OAuth client per RFC 7591.

## Request body

- object
  - `redirect_uris` string[], required — Array of redirect URIs for the client. HTTPS, localhost, and supported native app callback URIs are accepted.
  - `client_name` string — Human-readable name of the client.
  - `client_uri` string, uri — URL of the client's home page.
  - `logo_uri` string, uri — URL of the client's logo.
  - `scope` string — Space-separated list of requested scopes.
  - `grant_types` string[] — Grant types the client will use.
  - `response_types` string[] — Response types the client will use.
  - `token_endpoint_auth_method` 'none' | 'client_secret_post' — Authentication method for token endpoint. All clients are treated as public (no secret issued).
  - `software_id` string — Unique identifier for the client software.
  - `software_version` string — Version of the client software.
  - `contacts` string[] — Contact emails for the client developers.
  - `tos_uri` string, uri — URL to the client's terms of service.
  - `policy_uri` string, uri — URL to the client's privacy policy.

## Response `201`

- object
  - `client_id` string, required — Unique client identifier.
  - `client_id_issued_at` number, required — Unix timestamp when client_id was issued.
  - `redirect_uris` string[], required — Registered redirect URIs.
  - `client_name` string — Human-readable name of the client.
  - `client_uri` string — URL of the client's home page.
  - `logo_uri` string — URL of the client's logo.
  - `scope` string — Space-separated list of granted scopes.
  - `grant_types` string[], required — Grant types the client can use.
  - `response_types` string[], required — Response types the client can use.
  - `token_endpoint_auth_method` 'none' | 'client_secret_post', required — Authentication method for token endpoint.

## Other responses

- `400`

---

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