---
title: "POST /v1/oauth-clients"
method: POST
path: "/v1/oauth-clients"
tags: ["OAuth Clients"]
---

# POST /v1/oauth-clients

`POST /v1/oauth-clients`

Create a new OAuth 2.0 client for your organization

## Request body

- object
  - `organization_id` string, uuid, required
  - `name` string, required
  - `description` string
  - `redirect_uris` string[], required
  - `scopes` string[], required
  - `is_public` boolean

## Response `201`

Default Response

- object
  - `id` string
  - `client_id` string
  - `client_secret` string
  - `name` string
  - `redirect_uris` string[]
  - `scopes` string[]
  - `is_public` boolean
  - `created_at` string

## Other responses

- `default` — Unexpected error response

## Changes

- **2026-08-20** `6fe5e0368cb0` — 4 info
  - added the new `files:read` enum value to the request property `scopes/items/`
  - added the new `files:write` enum value to the request property `scopes/items/`
  - added the new `print-jobs:read` enum value to the request property `scopes/items/`
  - added the new `print-jobs:write` enum value to the request property `scopes/items/`
- **2026-07-26** `750c8a136307` — 6 info
  - added the new `fleet:read` enum value to the request property `scopes/items/`
  - added the new `fleet:write` enum value to the request property `scopes/items/`
  - added the new `inventory:read` enum value to the request property `scopes/items/`
  - added the new `inventory:write` enum value to the request property `scopes/items/`
  - …2 more

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/oauth-clients/post.md)

---

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