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

# Register an OAuth client

`POST /v3/oauth/register`

Dynamic Client Registration endpoint for platform clients. Registrations are attached to Scalev's official OAuth application for supported resource audiences. Public clients should use `token_endpoint_auth_method=none` and PKCE.

## Request body

- OAuthClientRegistrationRequest
  - `client_name` string
  - `client_uri` string, uri
  - `logo_uri` string, uri
  - `redirect_uris` string[], required
  - `grant_types` string[]
  - `response_types` string[]
  - `token_endpoint_auth_method` 'client_secret_post' | 'client_secret_basic' | 'none' | 'private_key_jwt'
  - `jwks_uri` string, uri — HTTPS JWKS URL required when registering a `private_key_jwt` client.
  - `token_endpoint_auth_signing_alg` 'RS256' — JWT assertion signing algorithm for `private_key_jwt` clients.

## Response `201`

Registered OAuth client

- OAuthClientRegistration
  - `client_id` string, required
  - `client_id_issued_at` integer, required — Unix timestamp, in seconds, when this client ID was issued.
  - `client_secret` string, nullable — Present only for confidential client registrations. Public clients using `token_endpoint_auth_method=none` do not receive a secret.
  - `client_name` string, required
  - `client_uri` string, uri, nullable
  - `logo_uri` string, uri, nullable
  - `redirect_uris` string[], required
  - `grant_types` string[], required
  - `response_types` string[], required
  - `token_endpoint_auth_method` 'client_secret_post' | 'client_secret_basic' | 'none' | 'private_key_jwt', required
  - `jwks_uri` string, uri, nullable
  - `token_endpoint_auth_signing_alg` string, nullable

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/revisions/730030bd6477/schema)