Update customer
Updates name, email and source_updated_at and returns the full customer. Omitted fields and null leave the stored value unchanged. The identity key and timestamps are immutable; sending one is a 422. A source_updated_at older than the stored one is a 422 carrying the stored value in meta.current_source_updated_at. Answers 404 for an unknown, other-organization or deleted id.
Authorizations
Path Parameters
The customer's Taxwire id (a cust_-prefixed ULID).
Body
The fields to change on a customer.
Omitted fields and null both leave the stored value unchanged. Any
other field (the identity key, timestamps) is immutable and a 422.
New display name. Omit or send null to leave unchanged.
500"Acme Wholesale"
New email. Omit or send null to leave unchanged.
320"ap@acme.example"
When the customer last changed in the source system. An older value than the stored one is a 422. Can't be cleared.
"2026-09-14T19:58:12Z"
Response
Successful Response
A customer: who is buying. Exemptions set in the app hang off it.
Taxwire's stable identifier for the customer.
"cust_01J9Z8Q4E7K2M3N4P5R6S7T8U9"
Your identifier for the customer in the system it came from. Pass it as customer.preset.id on a calculation to name this customer.
"CUS-1042"
"td3106586:1042"
The system the customer came from. taxwire for customers you send directly to this API.
business_central, campfire, maxio, monetizenow, netsuite, quickbooks, rillet, salesbricks, shopify, stripe, taxwire, xero "taxwire"
"netsuite"
The account the customer belongs to within source, as Taxwire's customer sync stores it. __default__ when the customer is stored without one: today that's every source except quickbooks and xero.
"__default__"
"9130349283746"
When Taxwire first stored the customer.
"2026-09-14T20:00:00Z"
When the customer was last changed in Taxwire. Equals created_at until the first change.
"2026-09-14T20:00:00Z"
The customer's display name.
"Acme Wholesale"
The customer's email. Not unique: several customers can share one inbox.
"ap@acme.example"
Set when the source system merged this customer into another; the id of the surviving customer. Null otherwise.
null
When the customer last changed in the source system, as reported by the sender. Null when unknown.
"2026-09-14T19:58:12Z"