---
title: "Create a client workspace (idempotent on external_id)"
method: POST
path: "/api/v1/partner/clients"
tags: ["Partner API"]
---

# Create a client workspace (idempotent on external_id)

`POST /api/v1/partner/clients`

## Request

- Base URL: `https://puzaricloud.in` (the document declares no server; this is the origin it was published from)
- URL: `https://puzaricloud.in/api/v1/partner/clients`
- Auth: none declared

## Request body

- ClientIn
  - `name` string, required: Shown in the partner's client list and inside the workspace
  - `external_id` string, nullable: Your id for this client (e.g. WHMCS service id). Unique per partner; creating twice returns the same client.
  - `contact_email` string, nullable: Client contact; login links log this person in as a client admin

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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