---
title: "Create a new Client"
method: POST
path: "/timmi-project/api/v4/clients"
tags: ["Clients"]
---

# Create a new Client

`POST /timmi-project/api/v4/clients`

Create a new client.

## Request body

- Client — A client must belong to a single [organization](reference/Timmi-Project.yaml/components/schemas/Organization). The organizationId field is required upon creation (POST) and cannot be modified later.
  - `id` number
  - `name` string, required
  - `code` string, required — **Unique** code for this client. Used for identifying the client in invoices export if externalCode is null.
  - `externalCode` string, nullable — Used for identifying the client in invoices exports. Is not subject to unicity.
  - `ownerId` integer, nullable — Unique identifier of the user managing this client.
  - `owner` object, nullable
    - `id` integer
    - `firstName` string
    - `lastName` string
    - `dtContractEnd` string, uri, nullable
    - `picture` object
      - `href` string, uri
    - `establishmentId` integer
  - `organizationId` integer, required — Unique identifier of the [organization](reference/Timmi-Project.yaml/components/schemas/Organization) this client belongs to.

## Response `201`

Created

- Client — A client must belong to a single [organization](reference/Timmi-Project.yaml/components/schemas/Organization). The organizationId field is required upon creation (POST) and cannot be modified later.
  - `id` number
  - `name` string, required
  - `code` string, required — **Unique** code for this client. Used for identifying the client in invoices export if externalCode is null.
  - `externalCode` string, nullable — Used for identifying the client in invoices exports. Is not subject to unicity.
  - `ownerId` integer, nullable — Unique identifier of the user managing this client.
  - `owner` object, nullable
    - `id` integer
    - `firstName` string
    - `lastName` string
    - `dtContractEnd` string, uri, nullable
    - `picture` object
      - `href` string, uri
    - `establishmentId` integer
  - `organizationId` integer, required — Unique identifier of the [organization](reference/Timmi-Project.yaml/components/schemas/Organization) this client belongs to.

## Other responses

- `400` — Problem
- `401` — Problem
- `403` — Problem
- `404` — Problem
- `500` — Problem

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/versions/110f9897756c/schema)