---
title: "Create new client"
method: POST
path: "/clients"
tags: ["Clients"]
---

# Create new client

`POST /clients`

Create new client

## Request body

- CreateClient
  - `name` string, required
  - `ext_tool_id` string, nullable
  - `info` string, nullable
  - `color` string, nullable
  - `active` boolean, nullable
  - `billable` boolean, nullable
  - `acronym` string, nullable

## Response `201`

Client created

- object
  - `data` Client
    - `id` string
    - `name` string
    - `company_id` integer
    - `ext_tool_id` integer
    - `info` string
    - `color` string
    - `active` boolean
    - `billable` boolean
    - `acronym` string
    - `image_id` string — The image id to fetch it over /img/{id}
    - `demo_flag` boolean
  - `success` boolean

## Other responses

- `401` — Error: Unauthorized
- `403` — Forbidden access or subscription and trial phase ended.
- `422` — Validation failed

---

[API](https://skmtc.net/timelink/apis/timelink-api.md) · [All operations](https://skmtc.net/timelink/apis/timelink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timelink/timelink-api/revisions/113f9953e62a/schema)