---
title: "Add a client (partner admins only)"
method: POST
path: "/partner/clients"
tags: ["Partners"]
---

# Add a client (partner admins only)

`POST /partner/clients`

Creates the client's Clerk organization (instance default member limit, nobody added implicitly), its account with one empty default business organization, links it to the partner and grants the caller admin. 502 CLERK_FAILED when Clerk refuses the organization (nothing is recorded).

## Request body

- PartnerClientCreateRequest
  - `name` string, required

## Response `201`

The new client

- PartnerClientResponse
  - `data` PartnerClient, required
    - `clerkOrganizationId` string, required
    - `creditsThisMonth` integer, required
    - `id` string, required — The client account id
    - `lastActivityAt` string, date-time, nullable, required
    - `linkedAt` string, date-time, required
    - `membersCount` integer, required
    - `myRole` 'admin' | 'member' | 'viewer', required
    - `name` string, required
    - `partnerStaffCount` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `502` — Clerk refused the organization

## Changes

- **2026-10-06** `461a0ebc7731` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/partner/clients/post.md)

---

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