---
title: "Create an OAuth client"
method: POST
path: "/v1/oauth/clients"
tags: ["oauth"]
---

# Create an OAuth client

`POST /v1/oauth/clients`

## Request

- Base URL: `https://api.typenode.ai`
- URL: `https://api.typenode.ai/v1/oauth/clients`
- Auth: HTTP bearer

## Request body

- CreateOAuthClient
  - `name` string, required: Display name after trimming surrounding whitespace.
  - `scopes` string[], required

## Response `201`

The client registration and its one-time client secret.

- CreatedOAuthClient
  - `client_id` string, uuid, required
  - `client_secret` string, required
  - `created_at` integer, required
  - `id` string, uuid, required
  - `name` string, required
  - `redirect_uris` string[], required
  - `revoked_at` integer, nullable, required
  - `scopes` string[], required
  - `tenant_id` string, uuid, required
  - `token_endpoint_auth_method` 'none' | 'client_secret_basic' | 'client_secret_post' | 'private_key_jwt', required
  - `updated_at` integer, required
  - `user_id` string, uuid, required

## Other responses

- `400`: The client name or requested scope ceiling is invalid.
- `401`: Authentication required.
- `403`: oauth_client.write is required.
- `429`: The per-user OAuth client-creation limit was exceeded.
- `502`: The OAuth issuer could not create the client.
- `default`: An error occurred (RFC 9457 problem+json).

---

[API](https://skmtc.dev/typenode/apis/typenode-management-api.md) · [All operations](https://skmtc.dev/typenode/apis/typenode-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typenode/apis/typenode-management-api/revisions/9b943024aa98?raw)