---
title: "Creates a new client for the current customer."
method: POST
path: "/client"
tags: ["Client"]
---

# Creates a new client for the current customer.

`POST /client`

## Request body

- CreateClientEndpointInput
  - `displayName` string, nullable — An optional display name for the client.
  - `organizationId` string, nullable — The organization to authorize the client for. Defaults to the caller's active organization.

## Response `200`

OK

- CreateClientEndpointOutput
  - `clientId` string, required — The id of the created client.
  - `clientSecret` string, required — The secret of the created client.
  - `organizationId` string, required — The id of the organization the client is authorized for.
  - `organizationName` string, required — The name of the organization the client is authorized for.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

## Changes

- **2026-08-31** `f5235270ce3c` — 3 info
  - added the new optional request property `organizationId`
  - added the required property `organizationId` to the response with the `200` status
  - added the required property `organizationName` to the response with the `200` status

[Change history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/client/post.md)

---

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