# Update a customer

> PATCH /customers/{customer_id}

Source: https://docs.trykintsugi.com/reference/2026-07-21/update-a-customer

PATCH /customers/{customer_id}

Update a customer

Update a customer in the resolved organization. Only the fields you send are applied. Sending any address field resets `addressStatus` to `UNVERIFIED`; the new address is validated the next time the customer is processed, not during this call. `taxRegistrations` upserts each entry on its `(countryCode, taxType)` pair and leaves unlisted registrations alone; it cannot remove one.

Category: Customers

Path parameters:
customer_id (string, required) - The unique identifier of the customer.

Request body:
name (string) - Customer name. Omit to leave unchanged; send a value to replace; send `null` to clear.
companyName (string) - Registered or legal business name. Omit to leave unchanged; send a value to replace; send `null` to clear.
email (string) - Contact email address. Omit to leave unchanged; send a value to replace; send `null` to clear.
phone (string) - Contact phone number. Omit to leave unchanged; send a value to replace; send `null` to clear.
street1 (string) - First line of the street address. Omit to leave unchanged; send a value to replace; send `null` to clear.
street2 (string) - Second line of the street address. Omit to leave unchanged; send a value to replace; send `null` to clear.
city (string) - City or locality. Omit to leave unchanged; send a value to replace; send `null` to clear.
county (string) - County or district. Omit to leave unchanged; send a value to replace; send `null` to clear.
state (string) - State or province code. Omit to leave unchanged; send a code to replace; send `null` to clear.
postalCode (string) - Postal or ZIP code. Omit to leave unchanged; send a value to replace; send `null` to clear.
country (string) - Country code, ISO 3166-1 alpha-2. Omit to leave unchanged; send a code to replace; send `null` to clear.
taxRegistrations (CustomerTaxRegistrationWrite[]) - Tax registrations to upsert, each keyed by (countryCode, taxType). Registrations you do not list are left unchanged, and omitting the field touches none. This field cannot remove a registration.
  countryCode (string, required) - Country the registration is valid in, ISO 3166-1 alpha-2. Part of the registration's identity: a customer has one registration per (countryCode, taxType) pair.
  taxType (PublicCustomerTaxTypeEnum, required) - Kind of tax the registration is for.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt