---
title: "Add a new client"
method: POST
path: "/v1/workspaces/{workspaceId}/clients"
tags: ["Client"]
---

# Add a new client

`POST /v1/workspaces/{workspaceId}/clients`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Request body

- CreateClientRequestV1
  - `address` string — Represents a client's address.
  - `email` string, email — Represents a client email.
  - `name` string — Represents a client name.
  - `note` string — Represents additional notes for the client.

## Response `201`

Created

- ClientWithCurrencyDtoV1
  - `address` string — Represents client's address.
  - `archived` boolean — Represents whether a client is archived or not.
  - `ccEmails` string[] — Represents additional emails for sending invoices.
  - `currencyCode` string — Represents client currency code.
  - `currencyId` string — Represents currency identifier across the system.
  - `email` string — Represents client email.
  - `id` string — Represents client identifier across the system.
  - `name` string — Represents client name.
  - `note` string — Represents saved notes for the client.
  - `workspaceId` string — Represents workspace identifier across the system.

## Changes

- **2026-08-20** `a5b636acbcd8` — 13 info
  - the `address` request property default value `` was added
  - the `email` request property default value `` was added
  - the `name` request property default value `` was added
  - the `note` request property default value `` was added
  - …9 more

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/clients/post.md)

---

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