Update customer (partial)
Update specific fields on a customer. Send only the fields you want to change — anything you don’t send stays as it is. To clear a nullable field, send null.
Set is_taxable to false to mark the customer as tax-exempt, or true to make them taxable. Omit the field to leave the current value unchanged.
Example — rename a customer:
{"name": "Acme Holdings, Inc."}
Example — update phone and website together:
{"phone": "555-0199", "website": "https://acme.example"}
Custom fields
Set custom fields by name:
{"custom_fields": [{"Partner": true}, {"Tier": "Gold"}]}
Each item is a one-key object where the key is the custom field’s name and the value is whatever you want to set. Use null to clear a field. If the name doesn’t match a custom field in your organization you’ll get a 422 back — we won’t silently ignore it. If you happen to have two custom fields with the same name, use the id-based shape:
{"custom_fields": [{"field": {"id": 42}, "value": {"custom_field_id": 42, "value": "Acme"}}]}
Omitting custom_fields from the request leaves existing values untouched.
Authorizations
Headers
Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.
255Path Parameters
Body
Partial update payload for PATCH /public/customers/{id}/.
Every field is optional: send only the fields you want to change. Unset fields are left untouched on the existing record.
1 - 6464(?i)^(?:[0-9\s+\-.\(\)]*|[0-9\s+\-.\(\)]+(?:\s*(?:x|ext\.?|extension)\s*\d+))$draft, posted, archived Whether tax is calculated for this customer. Set to false to mark the customer as tax-exempt.
Company IDs allowed to use this customer. Empty list means global (all companies). Omit or send null to leave unchanged.
Response
OK
Date and time the record was created
Date and time the record was last updated
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VES, VND, VUV, WST, XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT, YER, ZAR, ZMW, ZWL Schema for audit actor information.
Schema for audit actor information.
Schema for rejector information including rejection reason.