---
title: "Update client"
method: PATCH
path: "/consumers/{consumer_id}/accounting/clients/{client_id}"
tags: ["Accounting", "Clients"]
---

# Update client

`PATCH /consumers/{consumer_id}/accounting/clients/{client_id}`

Endpoint that gives the possibility to update an accounting client

## Path parameters

- `consumer_id` string, uuid, required
- `client_id` string, required

## Query parameters

- `folder_id` string, nullable

## Request body

- ClientItemUpdate
  - `external_reference` string, nullable — External identifier used to link the client in the accounting system with the corresponding client reference in your own system.
  - `first_name` string, nullable — Only used when the client is an individual (is_company=false). Indicates the first name of the client.
  - `last_name` string, nullable — Only used when the client is an individual (is_company=false). Indicates the last name of the client.
  - `name` string, nullable — Full name or legal name of the client (individual or company). This is the name that will be displayed in the accounting software.
  - `function` string, nullable — Only used when the client is an individual (is_company=false). Indicates the function of the client.
  - `is_company` boolean, nullable — Indicates if the client is an individual or a company.
  - `company_id` string, nullable — Only used when the client is an individual (is_company=false). Indicates the id of the company linked to the client.
  - `phone` string, nullable — Phone number of the client.
  - `mobile` string, nullable — Mobile phone number of the client.
  - `email` string, nullable — Email address of the client.
  - `language` string, nullable — Language of the client. Format: ISO 639-1 codes.
  - `internal_notes` string, nullable — Internal notes about the client.
  - `website` string, nullable — Website of the client.
  - `vat` string, nullable — VAT number of the client, used for tax compliance and invoicing. This value is unique per company and can be used as a reliable identifier to match clients between systems.
  - `company_number` string, nullable — National identification number of the company.
  - `iban` string, nullable — IBAN account number of the client.
  - `bank_account` string, nullable — Bank account number of the client.
  - `currency` string, nullable — Indicates the currency of the client (e.g., EUR).
  - `active` boolean, nullable — Indicates if the client is active.
  - `addresses` AddressItemOut[], nullable — List of addresses associated with the client.
    - `address_type` 'main' | 'delivery' | 'invoice', required
    - `name` string, nullable
    - `number` string, nullable
    - `box` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `email` string, nullable
    - `street` string, nullable
    - `city` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable — Format: ISO 3166-1 codes.

## Response `200`

Successful Response

- ClientItemOut
  - `external_reference` string, nullable — External identifier used to link the client in the accounting system with the corresponding client reference in your own system.
  - `first_name` string, nullable — Only used when the client is an individual (is_company=false). Indicates the first name of the client.
  - `last_name` string, nullable — Only used when the client is an individual (is_company=false). Indicates the last name of the client.
  - `name` string, nullable — Full name or legal name of the client (individual or company). This is the name displayed in the accounting software.
  - `function` string, nullable — Only used when the client is an individual (is_company=false). Indicates the function of the client.
  - `is_company` boolean, nullable — Indicates if the client is an individual or a company.
  - `company_id` string, nullable — Only used when the client is an individual (is_company=false). Indicates the id of the company linked to the client.
  - `phone` string, nullable — Phone number of the client.
  - `mobile` string, nullable — Mobile phone number of the client.
  - `email` string, nullable — Email address of the client.
  - `language` string, nullable — Language of the client. Format: ISO 639-1 codes.
  - `internal_notes` string, nullable — Internal notes about the client.
  - `website` string, nullable — Website of the client.
  - `vat` string, nullable — VAT number of the client.
  - `company_number` string, nullable — National identification number of the company.
  - `iban` string, nullable — IBAN account number of the client. DEPRECATED see bank_accounts
  - `bank_account` string, nullable — Bank account number of the client. DEPRECATED see bank_accounts
  - `currency` string, nullable — Indicates the currency of the client (e.g., EUR).
  - `active` boolean, nullable — Indicates if the client is active.
  - `account_number` string, nullable — Ledger account number assigned to the customer in the accounting system as it will appear in the official accounting export file (FEC, SIE, iXBRL, etc.).
  - `id` string, nullable — Id of the client in the accounting software. This is the unique identifier used to reference the client in the system.
  - `last_updated_on` string, date-time, nullable — The last time the client has been updated.
  - `addresses` AddressItemOut[], nullable — List of addresses associated with the client.
    - `address_type` 'main' | 'delivery' | 'invoice', required
    - `name` string, nullable
    - `number` string, nullable
    - `box` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `email` string, nullable
    - `street` string, nullable
    - `city` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable — Format: ISO 3166-1 codes.
  - `third_party_account` string, nullable — Third party account number/code representing the client in the accounting software.
  - `bank_accounts` BankAccountsItem[], nullable — List of bank accounts information associated with the client.
    - `is_primary` boolean, nullable — Indicates whether this is the default bank account for this third-party. Only one bank account per third-party can have is_primary set to true. Defaults to true.
    - `currency` string, nullable — Indicates the currency of the bank account (e.g., EUR).
    - `iban` string, nullable — International Bank Account Number (ISO 13616). Present for countries in the IBAN scheme (e.g., France, Germany, United Kingdom). null for countries that do not participate in the IBAN scheme (e.g., US, Canada, Australia).
    - `bic_swift` string, nullable — Bank Identifier Code (ISO 9362), also known as SWIFT code. 8 or 11 characters. Optional for domestic payments, but required for international wire transfers.
    - `account_number` string, nullable — Local bank account number. Used when the country does not participate in the IBAN scheme (e.g., US, CA, AU). Always paired with a routing_code.
    - `routing_code` RoutingCodeItem
      - `type` 'unknown' | 'ach' | 'sort_code' | 'bsb' | 'transit' | 'ifsc' | 'clabe'
      - `value` string, nullable — The raw routing code value, without spaces or dashes.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Validation Error

---

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