Skip to main content
PATCH
/
v2
/
clients
/
{id}
Update a client
curl --request PATCH \
  --url https://thirdparty.qonto.com/v2/clients/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "[email protected]",
  "extra_emails": [
    "[email protected]",
    "[email protected]"
  ],
  "phone": {
    "country_code": "+33",
    "number": "123456789"
  },
  "e_invoicing_address": "987654321",
  "vat_number": "<string>",
  "tax_identification_number": "<string>",
  "address": "<string>",
  "city": "<string>",
  "zip_code": "<string>",
  "province_code": "<string>",
  "country_code": "FR",
  "billing_address": {
    "street_address": "123 Main Street",
    "city": "Paris",
    "zip_code": "75009",
    "province_code": "<string>",
    "country_code": "FR"
  },
  "delivery_address": {
    "street_address": "123 Main Street",
    "city": "Paris",
    "zip_code": "75009",
    "province_code": "<string>",
    "country_code": "FR"
  },
  "recipient_code": "<string>",
  "currency": "EUR",
  "locale": "FR"
}
'
{
  "client": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "John Doe",
    "first_name": "John",
    "last_name": "Doe",
    "phone_number": "+33123456789",
    "phone": {
      "country_code": "+33",
      "number": "123456789"
    },
    "kind": "company",
    "type": "company",
    "email": "[email protected]",
    "extra_emails": [
      "[email protected]",
      "[email protected]"
    ],
    "currency": "EUR",
    "e_invoicing_address": "987654321",
    "vat_number": "<string>",
    "tax_identification_number": "<string>",
    "address": "<string>",
    "city": "<string>",
    "zip_code": "<string>",
    "province_code": "<string>",
    "country_code": "<string>",
    "billing_address": {
      "street_address": "123 Main Street",
      "city": "Paris",
      "zip_code": "75009",
      "province_code": "<string>",
      "country_code": "fr"
    },
    "delivery_address": {
      "street_address": "123 Main Street",
      "city": "Paris",
      "zip_code": "75009",
      "province_code": "<string>",
      "country_code": "fr"
    },
    "recipient_code": "<string>",
    "created_at": "<string>",
    "locale": "fr"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

​
id
string<uuid>
required

ID of the client

Body

application/json

When updating a client, you can only update the fields in the request body, defined in the schema below.

​
name
string

Name of the client that needs to pay the client invoice. It is required if type is company

Maximum string length: 250
​
first_name
string

First name of the client that needs to pay the invoice. It is required if type is individual or freelancer

Maximum string length: 60
​
last_name
string

Last name of the client that needs to pay the invoice. It is required if type is individual or freelancer.

Maximum string length: 60
​
email
string<email>

E-mail address of the client that needs to pay the invoice, which is displayed in the invoice.

Example:

"[email protected]"

​
extra_emails
string<email>[] | null

Additional email addresses for the client. Store additional emails that won't appear in the document but will be used as recipients when sending the document via email.

Maximum array length: 100
Maximum string length: 250
Example:
["[email protected]", "[email protected]"]
​
phone
object

Client's phone number.

​
e_invoicing_address
string

Specifically for French organizations. A unique address in one of the formats:

  • siren e.g. 987654321
  • siren_siret e.g. 987654321_98765432100012
  • siren_siret_routingCode e.g. 987654321_98765432100012_00001
  • siren_suffix e.g. 987654321_00002

Note the address should also exist in the Annuaire to be accepted.

Example:

"987654321"

​
vat_number
string

Value Added Tax number of the client (a legal entity) that needs to pay the invoice.

French VAT Number Format: If the VAT number starts with 'FR', it must follow this format:

  • "FR" is the country code (2 characters)
  • The "2-character key" is a checksum that can be two digits or an alphanumeric combination (letters/digits)
  • The final 9 digits are the company's SIREN number (the core French business identifier)

Example: FR12345678901 (FR + 2-character checksum + 9-digit SIREN)

Maximum string length: 20
​
tax_identification_number
string

Tax Identification Number (TIN) of the client. Format varies by country:

  • France: SIREN (9 digits) or SIRET (14 digits)
  • Italy: Codice Fiscale (11 digits for companies, 16 alphanumeric for individuals)
  • Spain: NIF/CIF (9 characters)
  • Germany: Steuernummer

Note: A client can be created without this field, but invoice creation may fail if the field is missing or invalid based on these rules. If you receive a validation error related to tax_identification_number when creating an invoice, update the client first and then retry creating the invoice.

Invoice creation requirements:

Maximum string length: 20
​
address
string
deprecated

Address of the client that needs to pay the invoice.

DEPRECATED: This field is deprecated. Please use billing_address.street_address instead.

Maximum string length: 250
​
city
string
deprecated

City of the client that needs to pay the invoice. DEPRECATED: This field is deprecated. Please use billing_address.city instead.

Maximum string length: 50
​
zip_code
string
deprecated

Zip code of the client that needs to pay the invoice. For clients with Italy as a country, the value must be 5 characters. For other countries, the value is capped to 20 characters.

DEPRECATED: This field is deprecated. Please use billing_address.zip_code instead.

Maximum string length: 20
​
province_code
string
deprecated

Province code of the client that needs to pay the invoice. It is required only for Italian organizations.

List of province codes: AG, AL, AN, AO, AP, AQ, AR, AT, AV, BA, BG, BI, BL, BN, BO, BR, BS, BT, BZ, CA, CB, CE, CH, CL, CN, CO, CR, CS, CT, CZ, EN, FC, FE, FG, FI, FM, FR, GE, GO, GR, IM, IS, KR, LC, LE, LI, LO, LT, LU, MB, MC, ME, MI, MN, MO, MS, MT, NA, NO, NU, OR, PA, PC, PD, PE, PG, PI, PN, PO, PR, PT, PU, PV, PZ, RA, RC, RE, RG, RI, RM, RN, RO, SA, SI, SO, SP, SR, SS, SU, SV, TA, TE, TN, TO, TP, TR, TS, TV, UD, VA, VB, VC, VE, VI, VR, VT, VV

DEPRECATED: This field is deprecated. Please use billing_address.province_code instead.

Required string length: 2
​
country_code
string
deprecated

Country code of the client that needs to pay the invoice as a root-level field (ISO 3166 format).

DEPRECATED: This field is deprecated. Please use billing_address.country_code instead.

Required string length: 2
Example:

"FR"

​
billing_address
object

Billing address of the client, which will be reflected on the invoice.

​
delivery_address
object

Delivery address of the client whose

​
recipient_code
string

Only for Italian clients. Represents the client’s recipient code, so that the client can receive the e-invoice in his SDI portal.

​
currency
string

Client’s currency in ISO 4217 format (alpha-3). Required when creating a client invoice and will be used as the invoice currency.

Example:

"EUR"

​
locale
string

Language of the documents created on Qonto (invoices, quotes, credit notes) for this particular client. It is possible to choose between five languages: French, English, Italian, German, and Spanish. Note, although we accept locales of format fr-FR we ignore the region part, treating this as fr.

Example:

"FR"

Response

Returns the client identified by the id path parameter.

​
client
object
required