---
title: "Registers an OAuth client (RFC 7591 dynamic client registration)."
method: POST
path: "/oauth/register"
tags: ["oauth"]
---

# Registers an OAuth client (RFC 7591 dynamic client registration).

`POST /oauth/register`

## Request

- Base URL: `https://api.pricklymails.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pricklymails.com/oauth/register`
- Auth: none declared

## Request body

- RegisterClientRequest: `POST /oauth/register` request body (RFC 7591 subset).
  - `client_name` string, required: Human-readable client name (RFC 7591 `client_name`).
  - `redirect_uris` string[], required: Redirect URIs the client may be sent back to after authorization; at least one is required.

## Response `201`

Client registered.

- RegisterClientResponse: `POST /oauth/register` response body (RFC 7591 subset).
  - `client_id` string, required: The generated public `client_id`.
  - `client_name` string, required: The registered client name, echoed back.
  - `redirect_uris` string[], required: The registered redirect URIs, echoed back.

## Other responses

- `400`: Invalid client_name or redirect_uris.

---

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